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PREFACE 


MANUAL OBJECTIVES AND READER ASSUMPTIONS 


The irtent of this software operational guide is to enable tts 
user to successfully operate the Systems Communications Module 
CSYCCPh) under control of the B13C0/EB17C0 Master Control Program 
CMCP). AS a Means to this objectives» this document defines scope 
and otjectivess» describes inherent and command driven functions» 
and presents bésic inmolementation chéracteristics.e. Additionally» 
it prevides operating procedures at tEcth the system and terminal 
level. (Terminal operating procecures are restricted to those 
capabilities within the scope of SYCCM.) 


The Systems Communications Module can te used for a multitude of 

applications and by users with varying degrees of proficiency itn 

computer operationse Although this ouide has a tutorial slant» 

it dces not claim tc train operators. The reader is assumed to 

have @ basic knowledge of the 8180C/B1700 system and of the 

Master Control Program CMCP). The reader 1s alsa assumed to he 

= familiar with £—1800/81700 aperating crocedures» to have had 

( experience oferating the Operator's Display Terminal CODT) and 

ue peripheral devices» and to have a tésic vocabutary of computer 

related terms. The user need not hcewevers» need any knowledge of 
progragming or of the Network Definition Language C(NDL). 


This guide is designed to be selfrccrtained. However » 1f the 
user wishes to have a deeper insight into the system's 
construction cr precise details as tc the various internal system 
functions»e a reading of the “Network Definition Language 


Reference Manual™ and the "System Software Gperational Guide™ is 
strongly recormended. 


STRUCTURE OF THE DOCUMENT 


section 1 presents an overview cf the Systems Communications 
Module along with the functions it performs. This section also 
identifies any limitations which might be applicable to the 
usefulness of the system and Lists asscciated documentation. 


Section 2 describes concepts and implementation characteristics 
employed by the Systems Communicatians Module.e Pictorial surveys 
are presented where applicabie toe elabcrate points of interest. 


Secticn 3 presentation of the Furcticral Description progresses 
fron Casic introductions» to what is involved» through detailed 
"how it works™ explanations. 


babies daar. 
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section 4 describes dapeceive commancs avattable to the ales from 
either a Work Station (Cterninal)d cr the User ODT. With these 


commands» the user directs SYCO4 te ferform specific functions to 
Satisfy 2 user's processing requirenentse Examples are offered 


for each command which incluges both command input and reply 


messagqeSe The commands are presented in alphabetical order for 
ezse of reference. The command language construction 1S 
presented in cetails including keyucrc/parameter semantics. 


Section 5 contains operating procedures for a SYCOM system 
Coperating independently or in conjunction with the Supervisory 
Messace Control Systen (€(SMCS)) and for tocal system terminals. 
Under the heading “System Operating Procedures» useful SYCOM 
operating procedures» commands» and operational hints/pointers 
are presentede Under the heeding "Terminat § Operating 
Procecures™» terminal operational- commands and functions are 
covered which assume either a TD82Z0 or T0830 Video Display 
Termirat CVDT). However » the system utilizes any Surroughs 
supported VDT device. | : 


Secticn 6 presents instructions for the preparation of a Network 


Contrcller program required by the SYCOM systeme- It is basicaily 


comprised of a sample NDL coded input file for the Controller's 


generative precesse Various comments are included throughout the 


sample Listing to explain variable parameter data which could be 
different for each installation. The procedure used to invoke 
the generative process for an operational Network Controller 
program tailored to the needs of individual systems is included. 


Section 7 contains apvendices to this document» each of which is 


identified below: 


Appendix A provides lists cf error messages and their 
meanings. These tists are broken down into two major 
categoriess those error messages which may tbe displayed in 
response to commands and these error wessages which are 
cisplayed on the User OOT which identify a processing 
exception condition within SYCOM. 


Appendix B contains the “character set”™ defined for terminal 
input/outfut and data transmissions. 


Appendix C lists "reserved werds™ recognized by SYCOM> 
either as a command or commard cption keyworde 


Appendix D) contains a “command summary™ that tists each 
command and briefly describes its purpose. 


Appendix E proevides a list cf all control messages used by 
the communications protocol eénc includes their associated 
format attributes. 


—, 


a, 


T'S 


BURROLGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1800/81700 SYCOM 
SANTA BARBARA PLANT Pe Se 2219 0458 CA) 


Appendix F presents a List of restricted MCP commands which 
gre permitted from a terminal cr ODT on the User System. 


Appendix G describes the PARAMETERS file attributes and 
Cetails the parameters record fcrmat. 


Appendix H provides a summary cof system files> including 
rames and purposeése 


Appendix I contains sampte application programs which show 
the mechanics of interfacing with SYCOM and the system's 
terainats for program~totprogram and = terminal-to~program 
communicationse These sample programs can also be utilized 
in the system test procedures cnce the appropriate Network 
Controllers are created and the systems installed. 


Secticn 8 is a glossary of terms and acrony™s used throughout 
this cocument. 
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INTRODUCTION TC SYCOM 


GENERAL 


The Systems Communications Module CSYCOM) program provides the 
B1800/81700 user with: 1) the carability to submit jobs to run 
on ancther systems» 2) to transfer files between two systems» and 
3) in general» to interactively obtéein services and information 
from another system with the ability te communicate with 


Interactive programs tn aremote system. Job run output can be 


returred to the submitting system Cufpon request) or directed to a 
peripheral device on the processirg system itself. Interactive 
output data is returned to the User System directly» via Network 
Contrcttlers. | | | : 


SYCOM along with its associated Netwerk Controller is responsible 
for all data communications with other systems» This includes 
performing the necessary functions tc establish Line connections» 
receive/transtit data» and execute the correct Line termination 
procecurese a | 


The Systems Communications Modute maintains a secondary level of 
contrel (MCP has primary control) cver Local peripheral devices 
such é@s the card reader» card punchs Line printer» and magnetic 
tapese It reads and transfers card» tare» and disk files» 
accepts input from and displays #essages to the Operator's 
Terminal CCDT) and receives data files/messages for printing» 
punchings display» cr writing te either tape or disk. It 
provides the mechanism by which a terminat or application program 
in one system is able to communicate with specific application 
progrems in énother system. Program selection is based on the 
servicing system which dictates the processing requirements 
Cprograms) optioned tc run in that system. 


SCOPE AND OBJECTIVES 


The purpose of the Systems Conmunications Module is to increase 
the use cf data processing facilities Csystems) either Local or 
remote to the target systen. The scape of SYCOM is to provide 
all of those features previously afforded by the Remote Job Entry 
CRJE/JTERMINAL) system and additionatty provide enhancements with 
the following expansive communications features: file transfer» 
termiral-to~program», program@to*prcgram» and program~to~SYCO0M. 
The first two functiors assume interssystem communications with 
the program@towSYCOM function assuming intra™system communication 


which is proviced by the MCP. The Systems Communications Module 
with these encompassing capabilities» considerably expands the 


flexitility of a RJE Station, herceforth referred to as a "User 
systenr". | | 7 
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In acdition to the above design ckjectives» several mandatory 
objectives have been specified. They ares 1) Retain 
compatibility with the standard &urroughs data communications 
Line ciscipline and #fessage format ccrventions and 2) maintain 
standard Remote Job Entry CRJE command compatibility with 
existing RJE program products for Burrcughs small» medium» and 
large systems. 


With this software system» the objectives are also to provide the 
user with the most benefits in terms cf flexibility and ease of 
uSC« Flexibility in that the user ts free to design and install 
syster configurations suited to the recuiremerts of the company 
for distributed processing. For example» auser can tnstall a 
Bi8600/B81700 in the same installation tc increase/share resources 
with an existing systems in a remote instatlation to place some 
resources 1n aremote factlitys or ina network of systems to 
provice cdistrituted processing services- Ease cf use in that all 
capabilities cf the system can be selectively utilized by = any 
user thru,either command initiated cr inherent system functions. 


FUNCTIONS PERFORMED 


Since SYCOM applications iauply transmission of large data fiies 
between two or more systems» Line throughput maximization» error 


detection» and error recovery are standard featurese Following 
1s a comprehensive List of the. functions per formed> including 
those that are urder user control. They are presented in three 


groupss Sasic»y Line Throughput» and Error Detection and Recovery. 


BASIC FEATURES 


For SYCOM to accomptish the functions generally described for the 


system,» the following basic features are provided> full details 
are presented in Section II» "Concepts and Facilities”. | 


Ae Input: Introduction of prcgrams from an input device 
on the tocal system for coacilation and/or execution on 
a remote systeme Introduction of data from an input 
device on the tocal system fcr processing on the remote 
system. 


Be Command Input: SYCOM cormmards as well as SMCS/MCP type 
commands are permitted froa the system O0T» terminals» 
and specificatty tailored epplication programs running 
in @ systefe 


Ce. Cutput: Dispersion of data and/or programs produced by 
the remote system to the tocat systens peripheral 
output devices» ODT» terminals» and application 


proaramse 
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De Monitoring: Monitoring anc controlling programs on the 


remote system via a local system*s Remote Supervisory > 
Console C(RSC)> virtual terminal» ODT» or application 
program Crequires SMCS on remote systen)e. | 


E. File Control: SYCOM verifies alt file transfers 
between two systemse 


Fe File Transfers: Yhe transfer of certain types of files 
between a tocal system ard a remote systems  $tn both 
directionse 


Ce Program*to~Program: Support of communication between a 
program running in a Local system and a program running 
in a remote systeme Also» support a ltocat arplication 
program communications Link to SYCOM itself. 


Fe. Virtual Terninals: Provide a means by which a 
terminats» ODT» or application program in a tocal systen 
can become a virtual terminal entity to a remote 
system. By designs» virtual terminals assigned the © 
status of a Remote QDT tf approapiatety dectiared as 
Server Stations in networkcontroltler when connected to 
a SMCS in the remote syste. : 


Ie. Communications? Supports — a full line o f ee 
communicationss asynchroncuse synchronous» and direct ( 


connecte Line speed is dependent upon Line Adapter 
capabilities. | | 


Je Security: The SYCOM controls “lLogq=on™ security» lLog-on 


involves checking a user*s security code and granting 
access to user files for transfer purposes. 


LINE THROUGHPUT 


Maximization of Line throughput is assured by a pointmto~point 
messdace transfer orocedure which: 


A. Specifically acknowledges receipt of a message with the 
transmission of either arcther message block or 4a 
“numctered acknowledgement" CZ#ACK) message. This 


reduces both tine time and turnaround timee 


B. Blocks records for transmissions (€Ci-ee@e» sends multipte 
data records per message block. 


C. Comecress and expand blerks i1n data records. It is 
common for card input and printer output to have a 
targe number of imbecced blanks. Eliminating 


transmission of these btéenks significantly imoroves 
line throughput. 
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FRROR CETECTICN AND RECOVERY 


The following features are provicec in errcr detection/recovery 
areas to assure reliable service to the system user: 


he A specific numbered acknowledgement Ceither in the next 
messcgge or in a #ACK) guarcs against the possibility of 
a lost message by croviding. an unambiguous 


acknowledgement for the trézrsmitted message block. 


B. The use cf modulo 2 by the transmission numbering 
facility for the detectior cf duplicate message blocks. 


C. Dynamic reduction Cby cormand) of the transmission 
message block size provides the potential for reducing 
errcr rates and retransmissions. 


Ce The convention of different timeout values for tocal 
and remote systems aileviate tine ccltlision preoblems. 


E « The message block transfer procedure eliminates the 
ambiguous use of certain ASCII control characters (for 
example» "ENQ” is used cnly during “establishment? 
and nowhere else). 


F . Data transmission error detection is provided thru the 
use of vertical and horizontal parity in the systems 
hardwaree 


LIMITATIONS 


The Systems Communications Module CSYCOM) is intended to provide 
a combined system of RJE» file transfer» program~to~SYCOM message 
transfer and terminalsto~program/procram=to"program communication 
capabilities. Te provide these services and stilt maintain a 
certain degree of compatibility with existing Remote Job Entry 
CRJE)D systemsse certain Limitations tecome inherent to the system. 
Therefore» applicable Limitations are defined as follows: 


Ae SYCCM does not» ard witl rect» support Cassette tanes as 
an optional peripheral device. 


E. In reference to “file trensfers”» the imolementation 
currently in effect does nct saves cr forwards» symbolic 
file headers. Therefore» certain file characteristics 


would te Lost on file transfers between unlike systems. 


Ce Program=to-Progras limitations involve an application 
program being assigned ¢é “virtual terminal™ position 
which reduces the number cf positions available § for 
terminal attachmentse | | 


Ce Interactive applicaticn pregrams in aremote system 
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serving virtual terminals cn a Local system cannot make 
use of “tatlies”™ or "toggles" ° 


fF. The implemented version cf SYCOM which this document 
describes» has only a Limited “file transfer recovery" 
capability. That is» any file queued to *PUT™ when the 
interwsystem connection is lcst» will initiate a file 
transfer operation from the “beginningtof~file”™ at 
SYCa, —6wBON after ccmmunications have been 
reestablished. : 


Fe The most noticeable Limitation is the fact that SYCOM 
only supports a single lire connection for RJE and Fite 
Transfer data communications at any one time. 


NOTICE 


The specifications of the software system described in this 
document are subject to change without noticee- The avaitability 
or performance cf some features Fay deperd on a specific 
conficuration of equipment such as tlarger memory or communication 
line speeds Customers should ccrsutt their Burroughs Sales 
Representative for details. 


ASSOCIATED DOCUMENTATION 7 | —_— 


Some cf the details of the Systems Ccmmunications Module system 
and its composite software elements ere contained in other system 
manuals. Following is a list of associated documents referenced 
in this guide. Readers and users cf this dccument may refer to 
any or all of these Listed documents for additional informatione 


Document Title Identification Number 
B1800/817C00 SUPERVISORY MESSAGE CONTROL SYSTEM PeSe 2219 0482 
MESSAGE CONTROL SYSTEM INTERFACE PeSe 2212 5447 
B1/700 NETWORK DEFINITION LANGUAGE PeS- 2212 5223 
B1800/81700 NCL LIBRARY P.Se 2212 5215 
B1i700 DATA COMM AUDIT PeSe 2212 5421 
6§1800/61700 SYSTEMS SYSTEM SOFTWARE 1068731 
OPERATIONAL GUIDE | 
Bi7OQ SYSTEM NETWORK DEFINITION LANELAGE CNDL) 1073715 
REFERENCE MANUAL | 
Bi700 SYSTEMS DATA COMMUNICATIONS 1089992 
INFCRMATION MANUAL © | | 
BURROLGHS CORPORATE DATA COMMUNICATICNS STANDARDS © 1284 9006 
B1800/B81700 SYSTEMS REMGTE JUB ENTRY CRJE)D 1090602 
| REFERENCE MANUAL 
B1800/B1790 SUPERVISORY MESSAGE CONTRCL SYSTEM. Preliminary 


SOFTWARE OPERATIONAL GUIDE 
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CONCEPTS AND FACILITIES 


GENERAL 


To elaborate upon the design concepts applied to SYCOMs» the full 
range of system facilities are preserted in togical progression. 
First to be covered are actual system hardware configurations. 
This provides the bese for further concept elaborations. Next» 
descriptions of the data comaunicaticn networks involved and the 
relationship of a User System to a Server System are identified. 
Following this» implementation ccncerts and functional aspects of 
the system are described. 


SYSTEM CONFIGURATION 


A User System criented to SYCOM utilizes a hardware configuration 


similer to the one shown in Figure II-1 (next page)» A system is 
usually comprised of the followinc hzroware elements: processors 
memory» OCT» cisk» pius standard comgunication controls/adapters. 
Opticratly at can be equipped with an assortment of peripherals 


as per a user’s needs Ce@sge» card reader» card punches disk packs» 


Line printers magnetic tapes» etce end terminals). 


The ‘SYCGM program is responsible fcr managing availability and 
use of peripherat devices which are used for SYCOM functions. It 
also controls atl input/output operations for those peripheral 
devices as well as transmitting and receivirg data files. CData 
file 3s a general term used here to encorpass all file types 
acceptable to SYCOM such as data» pegs source/object» printer 
backups etce) 


With this hardware configuration» “"<ell™ SYCOM capabilities for a 
User System are initiated thru the system ODT. An “extended” 
User System Cconfiguration with tlocal terminals) adds a new 
dimension to the SYCOM system in that it's capabilities are no 
Longer confined to initiation frcerw the ODT but are now also 
avaitable to ltocal terminats as well. Commands entered from a 
syster CDT can iritiate any SYCOM functions which includes 
establishing the Line connecticn for virtual terminal 
communications. Terminals ares howevers restricted to an 
explicit command repertoire. CDetaits of this concept are 
presented Later in this section.) 
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Figure 3.21: User Systesa Configuration 
SYSTEM COMMUNICATIONS 


Described here are the communicaticns network aspects of a User 
System and its relationship t9 a Server System. SYCGOM and its 
associated Network Controtler support User Systems using either a 
point=tompoint nonswitched or pcint*topoint switched network to 
a server Systeme 


The data comfunications procedure utilized 15s a subset of the 
Burroughs conversational point-to~poirt Line procedure. It 115s 
defined in a document entitled “Burroughs Corporate Data 
Commurications Standards"; refer tc “assoctated documentation”. 
That document fully describes the characteristics and functional 
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attributes for a non-transparent balf-duolex mode o f data 


commurication to which this system subscribes. 


PCINI“TO-POINT SWITCHED NETWORK 


In a switched network environment» a User System communicates 
with @ Server System without requirirg dedicated communication 
Lines; see Figure II-2 Con the follewing paged. The computers 
are ccnnected ty telechone Lines to the common carrier exchange 
servirg their respective locations. <A temporary connection (data 
path) is established between the computers only for the period of 


time in which data transmission is actuaily required. The. 


connection is established by dialing the telephone number of the 
server System. Usually the dialing crocedure is manual» however» 


SYCOM can cause this function tc te done automaticatily upon 


command directive. 


In switched tine networks» a line refers to a discrete data path 
between a Server System and the User System Cincluding terminals) 
thru the commer carrier exchange. The services provided by this 
commor carrier are usually on a timesused basis- 
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Figure 3-235 Point-to Point Switched Network 
POINT*TO“POINT NON“SWITCHED NETWORK 
A pointto~point nonswitched networks» as shown in Figure [I-3 


Cbelcw)» 


the computers are physically ccrrecteds 
making up the coamunications Line are 
and data may be transmitted over the 


dialing 


permanently 


consists of a private or tleegsed conamunications line that 
connects the User System with a Server System. 


In this networks 
thet is» the circuits 
established» 
line at any time. No 


1s recuired for this type of retwork. 
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Communication lines in a nonwswitched network are alternately 
known as private» teased» or dedicaeted linese In this document 
they ere referred to as “decicated Lires*. These lines may he 
privately owned (Ceege» internal cirect connection in the same 
physical location)» or provided by a common carrier on a contract 
basise This dedicated connection between two specific Locations 
would provide a tine for exclusive system use. 
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Figure 3-33 Point=to-~Poirt Nonmswitched Network 


COMMUNICATIONS PROCEDURE 


With the conversational point~tospcocirt commurications procedure 
assumed by SYCOM» inherent provisicrs include the capability to 
“reverse” message block trarsmissiors without having tc invoke 
separate establishment and termiraticn procedures. The essential 
characteristic of this capability is its ability to specifically 
“acknowledge” receipt of the previcus message block. This is 
accomplished by including a special acknowledgement character in 
the header of the “*next™ message block transmitted. This special 
charégcter 15 the Acknowlecge Receivec Message CARM) character. 


The usefulness of the ARM character is twofold? First» it 
provides a specific acknowledgement to the receipt of a previous 
message block by utilizing the “numbered ACK" facility. 


Secondly» when the receiving system receives a message block that 
at cannot accept (no buffer space or a specific peripheral is 
notwready)» the ARM character permits an implicit NAK of that 
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message block. This is achieved by transmitting the NAK in-~ the 


next cutgoing message block. 


USER SYSTEM ~ SERVER SYSTEM RELATIONSHIP 


Referring to Figure [1174 Cfoltowing page)» the User System is 
viewec as the system in the network which serves as a point of 
data collection and data distribution. For example» RJE type 
card input» card outputs» tine printer output» and/or’ terminal 
input/ output Messages. 


A Server System on the other hand is aeneratly considered to be 
the déta processing systems often referred to as a Host System 
or Centrat System. It normally receives targe volumes of data 
from < User System to be processed cr program source files to be 
compiled. In the case of program compilations» the printout and/ 
or ercgram object code files can be transmitted back to the User 
System Cupon request) for printing or possibie program execution. 
Interactive output ts returned directly to the tnittating program 
or terminal vie the Network Contrctlers. 
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Figure 374: User System = Server System Schematic. 
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The actuat physical size of a computer however» has relatively 


Little importance when considering a system as a Server System. 
The 81800 can be either a User or Server System» depending on the 


scope of the services provided at the time. It can atso  bep 


under certain circumstances» 
system at the same time. 


SYCOM AND ITS ENVIRONMENT 


HARDWARE REQUIREMENTS 


bett a User System and a Server 


The fcilowing List of equipment must be present for SYCOM system 


operationse 


However» the Listed equipment is not dedicated to 


SYCOM Cor suprorting system software) and is available for use by 


other programs. 
Hardware Type 


B1800/81700 Certral Processor 
9@ KB Main Memcry Cminiaum) 
Secondary Memcry Cdisk storage) 
Cieee head~perwtracks pack) 
120 or 132 Position Printer 
80 ocr 96 Column Card Reader 
80 or 96 Cotumn Card Punch 
System OOT COcrerator's ONisplay) 
Single or Multi Line Control 
Line Adapters as Required 
Cleased» switched» direct? 
Data Sets and Cables 
Cas required) 
TD82C/TDS830 Termirals 


MEMGRY REQUIREMENTS 


Usage 


System Control 


System Software 


Program/Data Files 


Line printer output Coptionatl) 
Certrol/RJE Type Input Coptional)d 
Controt/RJE Type Output Coptional) 
MCF/SYCOM/SMCS Onperations Coptional) 
System/Terminat Communications. 
System/Terninat Communications 


System/Terminal Communications 


As Required Coptional) 


Provided here is a list of System Software elements and their 


associated memcry requirements. 


They can be used to approximate 


memory requirements for an interactive B1800/B1700 SYCOM systens 
operzting with or without a Superviscry Message Control System: 


- 6420 KB Master Control Program (MCP). 

= 15.0 KE Network Controtler Ckasic). 

= 32-9 KE Each additionat Line in the Centrolter. 

-~ 16.0 KE Supervisory Message Control System CSMCS). 
- 18.90 KE Systems Communicaticrs Madule CSYCOM). 

~- 2220 KE Command AND Edit system CCANDE). 

= 220 KE Each additional terminal Logged=on CANDE. 
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After dnuavetiing the basic memory requirements re the system» 
additional memory =must be includec for ary other programs that 
are tc be executed in. conjunction with SYCOM. (See appropriate 
reference manuals for those menory recuirement estimatese) 


SOFTWARE REQUIREMENTS 


In order for SYCOM to become operaticnal» certain system software 


elemerts are required. Although these elements support the 
operation of SYCOMs they are general purpose and in fact support 
the ertire systeme Fach scftware element identified here is 


individualiy cocumented for its capabilities and requirements. 


Following is a list of those pertinert system software elements: 


= Master Control Program (MCP) 


- SYSTEM/MAKEUSER program Cif “usercodes” are used) 
- Network Controller prograam 


MASTEF CUNTROL PROGRAM CMCP) 


The MCP is an operating system which manages the demands and 
resources of 81800/81700 systems. It reduces programming efforts 
by previding - family of commonly neeced furctions and services. 


The CP requires strict user adhererce to pregram structures and 


procedures in order that there may be communication between the 
different programs» interpreters» anc the MCP itself. | 


its primary function is to optimize the productivity of a systems 
External intervention is held to a minimum» and maximum 
throughput is achteved by incorporating into the MCP the primary 
tasks of Input/Qutput CI1/0) centrols file | handling» 
multiprocessing» interrupts» memcry allocation» anplication 
programs» and operator interfaces. 


SYSTEM/MAKEUSER PROGRAM 


A utility program that is used to creates» modify» and access the 
system's “usercode™ file. This file contains all valid system 
usercode/password combinationse These usercodesmpasswords are 
maintéeined in a file named “CSYSTEM)/USERCODE”. With this file» 


the MCP can supports and enforce» a file security mechanism for 
disk fites and programs/users that access them. 
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NETWCRK CONTRCLLER PROGRAM 


The Network Controller is a Nettwerk Definition Language CNDL) 
type program whose prime function 1s to process and supervise the 
flow cf messages between systems» terminals» and programs. Ct 
performs all data communication line discipline functions which 
are necessary for proper tline/terminat control. The Network 
Contrcller hardles the initiation anc completion of communication 
I/O's and services exception conditions. In order to optimally 
provide these functtonss the Network Controller is configured» by 
NOL generation» to the specific neecs of the system on which it 
is to be runs (Ciee-e» the number and type lines» number and type 
termirats» etce)e A product of this generative process is the 
Network Information File CNIF). This fite ccentains all terninal 
and communicéetion tine attributes ~s well as Logical aspects of 
the ccmmunications networke 


Basically» this Controller enables sgessages to pass between it 
and SYCOM as well as other terminal criented programs executing 
in the system. This is accomplishec via MCP supported Remote 
Files and Queue‘s along with the Certroller's message switching 
capability. Each program that is tc be part of the message flow 
must contain a “remote file™ for input/output message traffic and 
7t must bte known to the Network Contrctlers this includes SYCOM. 


SOFTWARE OPTICNS 


The following software elements are rot required but may be used 
in conjunction with SYCOM to service a particular user's needs. 


- Supervisory Message Control System (SMCS) 
- Applicetion Programs 

=~ CANDE Program Cmultiplesuser text editing) 
= OMPALL Program 


Although the Supervisory Message Control System is not a required 
System software element for the cneration of a SYCOM system» it 
is definitely suggested for those systems which have terminals. 
A Terminal in a SYCOM system envircnaent is permitted to initiate 
“file transfers” or hbhecome a “virtual terminal™ entity on a 
server Systeme Additionally» these termirals may be utilized for 
other applications such és data ertry and program development. 
To maintain overall control of the terminals in these varied 
syster environ#wents» the SMCS becomes the controlling element. 


SUPERVISCRY MESSAGE CONTROL SYSTEM CSMCS) 


The ‘Superviscry Message Control System CSMCS) is intended to be 
the “supervisor™ for a data communications software system which 
incluces such Burroughs software elerents as “SYCOM"» CANDE» and 


3710 


-BURROLGHS CORPORATION | | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP — B18007B1700 SYCOM 


SANTA BARSARA PLANT oe Pe Se 2219 0458 CA) 


other online programs of either Burrcughs or customer origin. 


The SMCS provides to an interactive system» many functions and 
special features. To fully explcre its capabilities» please 
consult the "SMCS Seftware Operatioret Guide™. However » the 
highlights of some cf the more pertinent functions are presented 
heree Relevant to the SYCOM systew» SMCS prevides some _ hasic 
message switching Cterminal to terminal» terminal to ODT» and ODT 
to terminal)» attachment of termirals to application programs via 
a remcte files» and information abcut the system's network. 


Additionally» it controls terninat togton security Cchecking of 
user security codes and granting éccess to user files) and 
approves Cor denies) alt remote file cpens to terminats under its 
contrcl. Moreover» SMCS prevides @ certain degree of resource 
aliocéetion. Ey this is meant» thru security» job control» remote 
file controt» and error handling» the SMCS can allocate some of 
the systems resources. For exanples for every terminal under its 
contrct» SMCS has final control over that device as a resource. 
It céen therefore» temporarily “éettach™ terminals to SYCOM by 
means of the SMCS “SIEN ON® facility. — 


APPLICATICN PROGRAMS 


Effectively there are three types cf application programs useful 
to the SYCOM system user» they are: 1) Interactive data entry» ae 
2) systemmto systems and 3) commard irput to SYCOM. Each program _, mage 
type is briefly described here with details of how they actually 

work presented in the following “Functionai Description". 


A user can elect to develop an “"irteractive”™ application program 
tailored to specific needs of an instatlation. These specific 
needs could include such apolicatioréel functions as data entry» 
information retrieval» or any application desired. 


If there is a requirement for an application program in a User 
System to communicate directly with another application program 
in a Server System» the capability ts there» fhis communication 
tink is directiy thru the Network Cortrotlers and SYCOM has no 
role in this message traffic. SYCOM does however» initially 
aoprove a “virtual terminat™ Ilsn for icentification and control 
purposes.» This its a residual capability based on requirements 
for Network Controtiers by SYCO”. 


The third type of anplication prograg provides the source for a 
string of SYCOM commands to be performed on an automatic basis. 
Normetly this would be for cff“hours cperation but could also be 
utilized for common everyday occurrences of a work flow pattern. 
CAn example of this would be the “SLAVE/BACKUP* program.) 
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FUNCTIONAL DESCRIPTION 


GENERAL 


The operation of SYCOM is dependent upon support from a Network 
Contrcller proecram.e. This Network Certrotller provides interfacing 
Links between SYCOM ana the communications hardware (terminals 
and other systems). The controtler furnishes those services and 
capabilities which are outlined in ceneral with the preceding 
subjects» “Software Requirements”. Throughout this descriptions 
Network Coentrcectler functions are elaborated upon where it is 
necessary to maintain continuity of subject matter. Conctuding 
this sections functions of a Network Controttler are outlined. 


Functional features of the system are described in the following 
orders 


le Standard RJE 

2- File Transfers 

3e- Virtual Terminals 

4. Program=to~Program Coamunicaticrns 
Se Network Control 


The Virtuat Terminal capabitity contributes Terminat~to~Program»s 
Terminal to~SYCGM anc Remote Sunerviscry Console communicattonse 


STANCARD RJE FUNCTIONS 


The SYCOM program controls» at a seccndary Level» atl typical RJE 
peripheral devices of a User Systeme It reads and ounches cards» 
prints outputs» accepts ODT input» cisptays ODT output messages» 
and transfers file/control messages tetween the User System and a 
Server Systeme | 


Input can be directtly from a card reader» from tape or disk thru 
file eaquatess or from the ODT. Cerd reader tnput is generally 
associated with RJE batch data transzissionss whereas magnetic 
tape and disk Input more directly relates to file transfers. 
However» these operations in SYCOM are considered synonymous. 


Commands can be alternately input frcem a specifically designed 
application program thru the “Program-to=SYCOM”" facility. Kith 
this mechanisms» the RJE tnput as well as assoctated output could 
be automaticéetly controtled on a caily basis without requiring 
the system operator to enter a long sertes of commands to SYCOM. 


pn 
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Gutput can be made directly to a carc punchs Line printer» disk» 
Magnetic tapes» or ODT. Howevers in the case of a printer or card 
punchs the data received can be in the form of a “backup file” 
which 1s first written to disk. subsequent MCP commands are 
entered to cause printing or punchince as appropriate. 


Furthermore» SYCOM gives certain directives to the Network 
Contrcller such as requesting 1t to establish or remestablish a 
conrectiton to 4a Server Systeme.  SYCOM also causes the controller 
to enter an “*idte"™ state while waitirg for an incoming connection 
to be established and to terminate 2 connection when appropriate. 


The transmission of RJE data files tc/from a Server System occurs 
as follows: A user of the User System prepares a card deck for 
transmission to the Server Syste. The cards are read» 
compressed and O6locked by SYCOM Cupen command) and written into 
the Network Controller's remote filee (See writeup on "Queue 
Depth Controt".d The controtler begins immediately to transmit 
these card imaces Cmessage blocks) tec the Server Systeme This 
process continues until all cards have heen read and transmitted. 
The card file» known as a “job streaa"» is then under control of 
the Server System's MCP which processes that job stream as per 
directives included in that file Ccomspile and/or execute). 


All COT type messages which pertain to that job CBOJ»s FOU» and 
ODT messages) ere transmitted back tc the User System for display 


on the User ODT. Messages can be entered via the ODT to control 
jobs executing on the Server Systen cr manipulate data files as 
requireds previding a MCS is running in that systeme SYCcOM 


accepts these messages and writes them to the Network Controiter 
for transmission to the Server Systes and subsequent processing. 


When the job has finished» any associated tine printer and card 
punch output created at the Server System is transmitted back to 
the User Systene CThis is dependent upon the software system in 
the Server Systenm->, HOST/RJE does this automatically where SYCOM 
dees rote) The Network Controtler receives these incoming message 
blocks and forwards them to SYCOM via SYCOM*s remote file Cinput 
queue)s SYCOM then appropriately cprirts and/or punches this data 
on a User System peripherat device. 


The above described process descrites the flow of data between 
the User System and a Server Systems often referred to as a “job 
strear™. Any number of job streams may be initiated at the same 
time Cmultinte Server System MCP directives contained in one job 
file) from a User System. The nuater of jobs which can or will 
run on a Server System is Limited onty to tts capabilities to 
process them. 
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FILE TRANSFERS 


Fite transfers are supported for both disk and magnetic tape 
deviceéSe Files may be transferred between any combination of 
these devices. Magnetic tape transfers are restricted however» 
in thet only one file per tape may be transferred. Tapes created 
by the LCAD.-DUMPs» SYSTEM» and COPY functions are not supported. 
CThese tape files are first loaded tc cisk and then transferred.) 
The data communications protocol allcws transfer of onty one file 
at a times in each direction. | 


Whenever SYCOM is operating with a ccnnection to a "ASCII" system 
such as a B800» the following three File Transfer rules apply: 


1) Code files are always enccced» 


Zz) Data files are not encoded» nongraphic characters are 
replaced with question marks “?"» and 


3) Non-graphic characters in cata files can be transferred 
intect by specifying “SINARY™ af the COPY command 
stringe This forces erccding cf the data file 


specified Call records). 


The user initiates a file transfer ty entering a "COPY" or “"ADD™ 
command to SYCOM CPUT» RPUT» RFETCHE and FETCH are acceptable 
alternates). The syntax allows scocurce and destination systems to 
be specified CPUT» RPUT» RFETCH anc FETCH excluded) for _ the 
transfer via attributes. These source and destination system 
identifiers wust be the same as those _ specified in the 
*systemvid”™ control message at connection tnittalization time. 


If the specified source system is the User System» the transfer 
is a “PUT™» which is a transfer cof a file *tco” another system and 
1s based on SYCOM's *SYSTEMID™ parameter~j When the source system 
is a Server Systems» then the transfer is a “FETCH"s which is the 
transfer of a file “from” another system» also based on SYCOM's 
W"SYSTEMID™ pareéemetere 


The actual transfer of a file is initiated by exchange of control 
information tEetween systems», this process 1s often referred to 
as "handshaking". All file transfers gccur as SPUT*s"™- That is» 
1f ore system wishes to do a “"FETCH*"s» it sends a “*“Fetch message™ 
to the other system. This causes the other system to Initiate a 
“PUT™ sequence by sending a “Put Message” to the initiating 
system. PUT and FETCH messages completely specify both source 
and destination file attributese The PUT message elicits a "Put 
Reply Message"» signifying that daté transfer may begin. The 
sender system then sends one cr acre data message blocks which 
are eventuatly fotloned by an endtof~file message. 
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Upon completicn of the file transfers» the system that received 
the file informs the originating system of the completion. This 
notification is made with a “user=destined eee message” 


if savor syetew wae nes to abort an in-process file transfer Cfor 
any reason)» that system sends either an "Abort Put" or “Abort 


Fetch" system control message to the other system. An abort 1s 


Initisted by the appropriate commanc entered to SYCOM. Alternate 
"device not ready = suspend” and “device ready = resume” messages 
are used for flow control at any time for temporary stoppages-» 


A file transfer request that canrct be processed when entered» 
because another file transfer is In frogress» 1s queued to disk 
and processed when next possible. Although there is a maximun 
depth to this disk queue Csee “*Restrictions")» it is sufficient 
to handte alt but the most extreme cases- This feature prevents 
request rejections due to the fact that only one fite transfer. 
Cin each direction) can be inprecess at any aiven time. 
Requests are queued on a first come» first serve», basis. This 
mecharism assures an orderly processirg sequence. | 


MAINTAINING INTEGRITY OF FILE CHARACTERISTICS 


A goal of the file transfer mechanis# is to maintain as many of a 


fiie"s characteristics as possible throughout the transfer. For 


example» tf a COBOL source program 1s transferred» it shoutd be 
capable cf being conpiled» without further modification» on the 
receiving system. Likewises if ao procram code file is 
transferred to a "*lLike system"» it shculd be executable without 
modification. | 7 


Specifically» if a file is transferred between two like systems» 


even if via one or more unlike systeas» all file characteristics 
must te preserved. Te accomplish this» a symbolic version of the 
file"s header Cunderstandable to alt systems) is transferred with 
the file. This symbolic file header is the "PUT~“ORTFETCH@“RECORD" 
as defined for SYCOM file transfers. It is prefixed in the data 
stream by a beginning-of~header control message. . 


In the receiving systeme when 3 symbclic file header is received» 
as Many as possible of the fila charéecteristics are incorporated 
into the file being created/received. If the fite is transferred 
to an “unlike™ system» tha symbolic file header and the original 


System type are saved with the file» to be forwarded with the 


file whenever it is again transferred. If the file 15s 
transferred to its original system type» the entire symbolic file 
header 31s Incorporated to create a file identical in 


Characteristics to the Bergan file» and the symbolic header is 
not saved. | 


When a system sends cne of its own files» it must include in the 
symbolic file header» enough information for it to recreate that 


file if returned. If this file is returned» it must be made to 
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Look identical to the original file» with the exception of "file 
name™ Cthis 1s conveyed in the symbolic file header). 


An unlike system created file may be changed cr replaced locally» 
thus invalidating the saved symbolic file header. In this case» 
the symbolic file header describes the file according to its new 
creation system type. 


Note: The “"symbotic file header™ discussed above is not 
implemented in this version of the system software. It 
will» however» be availabte ir a tlater release. 


VIRTUAL TERMINALS 


To the SYCOM system» a “virtual terminal™ can be either a tiocal 
termiral» the system ODT» or an application programe Therefore» 
virtuzi terminals is a togical capability whereby a message path 
can be established between a terminals ODT» or program on the 
User System and an appropriate interactive application program in 
a Server System. Additionally» utitize the inherent capability 
of cartrolling jobs in a Server System with a special MCP command 
repertoire. Basicatly» on the Server System end» this becomes a 
reality thru the capabilities of the SMCS. However» the main 
interc-system connections are established by SYCOM which makes it 
possitle. Refer to Figure 471 for a pictorial overview of a User 
Syster with virtual termirals. CInteractive application programs 
can Ee any program using a “remote file” but not using “tatlies” 
or “toggles™.) 


The terminals are virtuai in that alt User System facilities as 
well as ail Server System facilities are available to the system 


user. User System commands are locat and are therefore» 
processed within the User System by either SYCOM» SMCS»s MCPs or 
applicéetion program. Server Systew input wessages are accepted 
by the User System. ard transmitted tc the Server System (via the 
Network Controtlers) for processirg and subsequent reply 
messagese | 


In view of a “virtual terminal” tin an interactive environment» 
server System commancs must be forwarded as socn as possibie. To 
effect this requirements» SYCOM has the capability to “*interteave”™ 
a “user destined control message“ into the data transmission 
streaz immediately if a file trarsfer is in progress. The 
contrel message which contains the virtual terninal message is 
immediately transmitted or an incividual basis to the Server 
system. 
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TERMINAL=TO-PROGRAM COMMUNICATIONS 


When SYCOM is utilized in a larger system development. or data 
entry environgent Cwith terminals)» then the User System depicted 


in Figure 471 on page 4-7 is applicable. In that 
hardware/software configuration» the complete spectrum of SYCOM 
capabilities are availabie te the system usere To be more 


specifics in additicn to the capabilities previously identified» 
a terminal-to-program capability is available to the terminal 
user. | : 
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In this environments SYCOM still ccenunicates directly with the 


Network Controtiter for normal coamurications activity- However» 
the S¥YCS maintzeins elementary controt cver SYCOM and control over 


a system's terminals. To clarify this» the SMCS directly causes 
the execution of SYCOM when a terminal Cor RSC) “"signs~on™ to 
SYCOM thru the SMCS. A terminal user can ther direct commands to 
SYCOM in the User System or the SCS in either the User or Server 
Systete Exactly which commands and how the directives are given 
is covered in Sectior V» “Terminal Gperations". Note that these 
capabilities are also available to the user who optionally elects 
not to utilize a SMCS in the systen. (Refer to Figures 475 and 
4-6 for configuration overviewse) | | 


with the itntrecdcuctiocn of the SMCS software element into a systems 
alt cf its commands» functions» and capabilities become available 
to the terminal user. (Refer to the “SMCS Software Operational 
Guide™ for details and capabilities.) a 


Before proceedings tt might be helpful to this discussion for the 
terms User System and Server System tc again be clarified. A 
User Systen is the computer on which there are ternminais/users 
Wishing to encage in tnteractive computing sessionse The Server 
System as the computer that supplies those interactive services 
on a demand basis. (CRefer to Figure i274 previous section.) 


The ccmumunications protocol assumed ty SYCOM supports User System 
terminals connected (Clogicatly) tc an interactive application 
progréem on a Server System. Using this protocol minimizes’ the 


visibility of interfacing software elements so that to a users it. 


appears as though the terminal 1s connected directly to the 
application ocrograme The terminel its then used as if it was 
Locally attached to that program Csee "Massage Path Assignments* 
further on in this section). | 


Presently avéeilable interactive aprlication programs may be used 
or the user can optionally elect to develop a special application 
progrem for terminal and/or other precgram interaction. 


The method for conveying terminal data between two systems makes 
use cf the "device address” fieid in the control message. This 
message specifies the terminat with which the message text 15 
associated. The device address tn the context is terued “virtual 
address™»s and is the name used by beth. User ard Server Systems to 
reference a particular terminate This addressing scheme follows: 


Ae The cevice address is comprised of two characters, one 
upper case and one lower case alphabetic tletter. 


B. The User Syster “transmits™ a virtual terminal address 
as tcwer case/upper case tletterse hkhen it "receives”™ a 
response message from the Server System» the terminal 
address Letters are reversecs upper case/lower case. 
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C. The Server System “"receives™ a virtual terminat message 

with a device address cf tlower/upper case letters Cas 
transmittec by the User System). The virtual terminal 


addressing scheme thar recuires the Server System to 
"reverse™ these device address characters prior to its 
transmission back to the User System. (CThese transmit/ 
receive device addresses are specified in the Network 
Controtter's NDL generéetion proacesss on “both™ 
systems.) 


Ce Assume that a User System supports a connection for 
five terminals to a Server System. The User System 
refers to these termirals by virtual terminal 


Ctransmit) address: 
aA» tA» cA» dA» and eA 


The Server System also refers to these same terminals 
by virtual terminal Ctransmit) address; but» as the 
Server Systems role 1s reversed» its transmit address 
is also reversed. For exanrpte: 


Aas Ao» Acs Ads and Ae 


The following events represent the terminaltoctprogram procedure 
implemented ty SYCOM. These everts portray an Interactive 
sessicn between a virtual terminat on a User Systen and an 
application program on a Server System. 


The User System 


At initialization time» SYCOM issues 2 “remote file information” 
request to obtains from the Network Controtters the Logical 
Station Numbers Clsn"s) for the virtual terminals assigned to the 
Systeme These numbers gre placed irtc a table which maps_ the 
actual “tsn”™ of each virtuat terminal into a virtual "ltsn™ with 
which SYCOM cén reference the corresronding virtual terminal. 


When 2 user wishes a connection to a Server System» a *.CONNECT®™ 
command 1s entered to the User System's SYCOM. SYCOM finds the 
"next" available entry in its “virtuéel lsn table” and transmits a 
"connect message™ to the specified Server Systean. This control 
message contains 32 virtual terminal eddresse Upon recetpt of the 
"connect reply message”™» SYCOM rerpiies with the results. 


During the life of a connections all data messages entered from a 
virtuéel terminal are sent to the Server System for processing. 
CExcluded are any tocal SMCS commands which are prefixed with the 
assigred siqnat character-e) This is accomplished by doing a 
remote file write to the Centrotter using the terminal's virtual 
terminal “"“isn". In processing this sessage» the Controller maps 
the virtual terminat tisn into the assigned virtual terminat 
address (two characters). fhe nessace 1s then transmitted to the 
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Server System» according to SYCQ® crotocol» with the virtual 
terminal addresse The terminat user can then “sign on” to-— any 
application program that is supperted in the Server Systems 
provicing the capability is inherent in the form of a MCS. 


Any incofing wessage to the Network Controtter from a SYCOM Line 
which contains a virtual terminal adcress Ce@eges “Aa™*» “ADs etc) 
is sert to SYCOM.~ These messages are written into SYCOM*"s remote 
file CLINK) by the Controller with 2 device address appropriate 
for the terminal. | SYCOM upon readirg the message» searches the 
virtucl termirat address table fcr the actual system *lsn™ for 
that terminat. SYCOM then puts the actual “tsn” into the reply 
message and writes it into the Network Controiler's remote file 
Cstation queue) for distribution to the originating terminal. 


In the case where the virtual terminal 3s actually an application 
progrem» the reply message ts sert te that program via the queue 
mechanism for “program=to=SYCOM" communications. 


KHhen the user wishes to disccnnect frem the Server System» a 
".DISCONNECT™ command €.BYE command or *OFF command may also be 
used) is entered to Lecat SYCOM which transmits a “disconnect 
message” to the Server System» specifying the virtual terminal 
address to be disconnected. The terminal is notified of this 
action and is then free to establish another connection or work 
pattern as desired. | : 


The Server System | | | | 


The Server System's Network Controller intercepts "connect™ and 
“"disccnnect” wessages Cuntike all other control message which are 
routec to SYCCKM). Qn receipt of a “ccnnect message"s»s the Network 
Contretller verifies that the addressed virtual terminal exists» 
checks to see If it cén support another connections and that sone 
tnteractive application program 1s ready to accept input from it. 
If alt is corrects» the Network Certroller returns a “connect. 
reply message” indicating successful completion- else the 
Contrcttler sends back an error resporse tn a “connect reply 
message". | 


When the connection 1s successful» the Server System nakes this 
virtual terminal appear as a terminal lecal tec that system. If 
the user is “lLogged=on” to SYCOM» ther that user is automatically 
*"lLogged-on™ to the Server System's SCS. 


During the life of the connection» ary input data received by the 
Server System's Network Controtler for an enabled virtual station 
is conveyed te the waiting applicaticn program thru its remote 
file Ccoutd te tne SMCS). This message transfer transpires in 
exactly the same manner as for Locat terminals. Any output data 
generéted by that application pregrém is transmitted back to the 
User System» with the virtual terminat address specified» 
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The Server System upon receipt of a “disconnect message™» takes 


necessary action to detach that virtual terminal and respond to 
the User System with an appropriate “disconnect reply message"- 


If the user wés lLoggedon to the Server System's SMCS» then that 


user witl be sgutomaticaily "“lcgged=cff" the virtual terminal. 


REMOTE SUPERVISORY CONSOLE CRSC) 


It is an inherent capebility of the system to utilize the ODT» an 
application programs or aterminal in a User System as a "Remote 
OOT" to a Server System. This only occurs when» as Figure 4-2 
shows» a copy of the SMCS tis running in the Server System. For 
this systems the CDT ts also referred to as a “Remote Supervisory 
Console*"» or simply the RSC. This term was selected to imply 
capabilities which transcend normal capabilities of a ODT. This 
interface infers communication Cyia the SMCS) with a Server 
Systeg's MCP» hence the term» Rewote Superviscry Console. 


Messages input from the RSC to SYCO™M are grouped into two basic 
typess~*Local SYCOM and Remote MCP. Local SYCOM input includes 
commands to initiate file transfers» request SYCOM status data» 
and cther such functions. Additionally» respond to conditions 
within SYCOM%’s domain that cannot be preprogrammeds such as card 
reader not ready» clear peripherals» etcee 


Remote MCP commands permitted from a RSC are basicatly directives 
used for control over the execution cf jobs in the Server Systems, 
all via the Server System's SMCS. Cnty certain MCP coumands are 
permitted from a RSC Creference Appendix F»s "Restricted MEP 
Command Summary") when the RSC'"s “virtual terminal™ assignment is 
not declared as a Remote OOT in the Server System"s Network 
Ceontrcilers otherwises only Remote CCT restrictions apnoly. 
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Output messages for RSC acisplay can be grouped into four typess 
they ares Local SYCOMs» Local MCP» Remote SMCS» and Remote MCP. 
Local SYCOM outecut messages are rernawally responses to commands 
but can also be error type messages reporting SYCOM problems. 
Local MCP outonut would include such messages as *NO PRINTER 
AVAILABLE” anc other such informatior wessaces which pertain to 
operations of a SYCQM = systen. Remote SMCS messages would be 
replies to SMCS commands entered for processing by the Server 
System's SMCS. Remote MCP output messages include ODT type 
output resulting from jobs run on 2a Server Systeme These 
messages are routed back to the User System's SYCOM program for 
display. 


In the case where the RSC is actually an application program» the 
resporse messace 1s directed to that program via SYCOM's “program 
to SYCOM* queue mechanism. 


Referring again to Figure 4°72» assuge for examole» that a user 


wanted to execute a job on the Server System. Assume also that 
the subject program and alt data recuirements reside in the 
server System. The appropriate command string is entered to the 


User System's SYCOMs via the ODT/RSC.~ SYCOM accepts this message 
from the MCP» formats and transmits it to the Server System’? via 
the Network Controller. CThe comnand string could also be 
entered from either a tocal tersgirat or application programs 
Althcugh these message npaths are stightly different» the end 
results are the same.) 


In the Server Systems» the SMCS receives the MCP command message 
(from the Network Centrolter) and “zips” it along to the MCP. 
The Server System*s MCP processes the recuest as asked. Att 
output messages pertaining to that job are given to the SMCS 
which in turn inittates transmissior tc SYCOM tin the User System. 
User SYCOM then displays these tessaces on its ODT/RSC. 


From this we can see SYCOM*s tnvolverent and the processing’ flow 
involved i1n this type of operaticr. Ail preceding functions 
described for the RSC are over and above the standard User ODT 
Input/output messages used for normal lser System operations. 


stnce SYCOM is symmetrical» both systems can perform an identical 
set of functions» providing of courses both systems are of the 
seme seriese Actual input and output messages are exemplified in 
Section Vs» “System Operating Procedures". 


PROGRAM=TO-SYCCM COMMUNICATION 


The séme range of functions are possitle for the Progran=to~SYCOM 
facility ¢s for Terminal~to-Program Communications. This feature 
1s mace possible by an adaptation of the Terminat~to7Program 
schemee 
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AD mechanisn Cok. implementation secenCnne nature) as provided te 


allow an application program in the Lser System to. masquerade as 


a “terminal". | This application program must format messages 


prececed by the program header to appear as if they were terminal 
keyboard inpute These messages ére then written into SYCOM's 
"SYCOM/OUTQ™ cueue fer processing. — | | 


From this point on» at least inka a pany message 1s returned-p 
processing for SYCOM is the same as terminal~to~program commands. 
When SYCOM procuces a reply message» it writes the message into 
tts “SYCOM/INQ™ queue file from where the application program in 


turn feads this gueue to obtain the sessage- These reply 
messages are formatted tc terminal display specifications. 
Therefcres» the application program cén either print» stores 


Ignores parses or display select message text as appropriate for 


the program. 


The schematic on the following page CFigure 473) provides an 


overview of the mechanics for *Program™to~SYCOM Communications”™> 


Ccemmurication ctetween the applicaticr program and SYCOM is thru 
the previousty identified pair of “queue files".» The application 
progréem gives a commard to SYCOM by ariting into SYCOM's input 
queue file named "SYCOM/OUTQ". The application program obtains a 
respcerse message by reading from SYCOM*s “SYCOM/INQ” queue file. 


Message Formats used for “"Program@tc"™SYCOM™ communications are 
defined in Section VII>s "Appandix E"™. No command restrictions 


are enforced for this method of SYCO¥/system control. However » 
this feature is controlled by the SYCOM parameter “PROGRAM” and 
for this function to be available» that parameter "must be 


specified when the “"SYCOM/PARAMETERS" file is created. 


The SYCOM command “PROGRAM™ aay be used to interrogate the 
current value of the PROGRAM parameter. If it 1s entered (from 
the system CCT or a station knowr tc the SMCS as a remote ODT» 
then the default value af the PROGRAM farameter may be changed 
during tater execution of SYCOM. 
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Figure 4°32: Program~to*SYCOM schematic 


PROGRAM“TO~PROGRAM COMMUNICATIONS 


The prograntto~program capability employs an entirely different 
concert for intercsystem comaunicaticre As previously discussed» 
this feature 1s an inherent by=“prcduct of the systen. SYCOM 
itself is in no way involved with the crogram~to~progran message 
traffic end therefore» does not ecrevide any services to either 
programe The anly exception to this is that SYCOM does “approve™ 
a virtual terminal position for the pregram communications pathe 
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As shown in Figure 474 C(below>» communications are direct thru 
the Network Cortroilers via a special “remote fite™ dectared in 
each Controiters explicitly for thét purpose. Both anplication 
progréems wtust heave mirror images of these remote files Cone each) 
deciéred as well. This remote file is shown in both Controttler 
examples (Section VI) as well as both saaple epplication programs 
CApperndix I). | | | 


Figure 474 can be used to visualize how an application program in 
one system can communicate with a prcgram in another systeme The 
input/output path as for the procram to accept input messages 
from the Network Controller and return output reply messages’ (for 
transfission to the cther system/precgram. It would behoove the 
develcper of these application programs to desian a specific set 
of messages which exclude ary termirel connotations. This could 
greatly simplify development efforts extended for these programs. 


The User Syster 


The Server System 
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Figure 4-42 Program-to-Frogram Schematic 


To corvey certain recuired informaticns each input/output message 
must be prefixed with a “*header™. The format of this Header is 
defined tr Sectior 7s “Appendix Es» Message Fcrmats”. There are 
no restrictions as to the text in these messages but the Length 
1s controlled with the parameter “BUFFER*. This parameter is in 
the “SYCOM/PARAMETERS™ file and is specified at initialization, 
or chénged during execution by using the "BUFFER™ command. 


The usefulness of this feature must te evaluated and decided upon 
by the system user. The capability is there to be utilized for 
whatever purpose. 
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NETWORK CONTROL 


The SYCOM User System is normally corsidered to be the remote RJE 
Staticn and must initiate the transaission of data to the Server 
Systete In @ pointto~point nonswitched networks this is 
accorclished automatically by enablirg the line adapter and then 
exchanging handshaking control messages with the Server System. 


In a point "to~point switched network» the User System must call 
the ‘Server System. This is accomplished by either dial-out 
Cautomatic diating by the computer) or by manuat dialtuo Cdialing 
performed by the systen operator). The dialing is done “after” 
the adapter is enabled.~ When the Lire connection is established» 
the exchaéngirg of handshaking control messages with tne Server 
Syste 1s carried oute In a point“tocpoint nonswitched network 
utilizing a direct cannecticns» no dieting is doner or passible. 


Once this cammunication tink has been established with a Server 
System» Line communitcation is identical for the switched and 
nonswitched networkse CThe User System ard the Server System 
must be compatibte as to transmission rate and other such 
optioral hardware capabilities.) 


CONVERSATIONAL COMMUNICATION PROCEDURE 


The following notes refer to the basic conversational tine 
discipline erployed by SYCOM. They arply te a poitnt™to~point 
circuits» either dedicated or switchec: 


Message Transfers: 

All message btocks are detireated by special characters. 
Messages Legin with a “SOH” character anc end with a “8CC* 
character. The message control format is as follows: SOQH» 
ARM» TMZ» STX» ODAl» DAZ» message text Cblocked records)» 
ETX» and finalty the BCC. 


Retranssisston af Message: 

Ifthe transmitting system dees not receive a reply to its 
last transmission within a given period of time» the 
unacknowledged sessage block 1s retransmitted. 


Parity or Block~-Check Error Hanctling: 

If the receiving system receives a rececgnizable message» but 
it contains either a parity or Etlockwcheck errors» it replies 
with a “NAK"™. The transmitting system should retransmit the 
message. This is repeated “n™ number of times (C*"n" being 
user speciftieddJ» ard if the errcr oersists» either system 
can initiate error recovery. 


page 
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Message Idle State: 

If the receiving system receives a “good” message» but has 
ro message traffic to send» it responds with an "ACK". Tf 
the sending system has more aessage traffic»s Tt sends 
another message block. If the sending system has no more 
message traffic» it proceeds te the "message idle state”. 


Noragal Termination: 

The normal termiration of a ccrversation occurs when one 
system sends an “ACK" Cindicating that it has no more 
message trafficd» and the system receiving the “*ACK™ also 
has no more message traffice The system receiving the “"ACK* 
croceeds to the “message idte state*. 


POINT*TO“POINT CONTENTION PROCEDURE 


The essential characteristic of this procedure is that after the 
end~oaf"message transfer» as indicated by the transmission of the 


"DLE“EQT" sequence» toth systems are in an idle state. Either 
system may then bid for master status by sending the “DLE-ENOQ" 
sequences This is normally initiated by the entry of a command 
to SYCOM. : | 


Master Status: . 
If either system is in the idle state and wishes to begin a 
message transfer» it may bid fcr master status by sending 


the “DLE-ENQ"™ sequence» If the same system had just 
terminated a message transfer by serding a "QOLE-EOT™ 
sequence» then there is a delézy created before this system 


again sends the “DLETENG”™ sequercee 


Begin Message Transfer State: 

If the system bidding for master status receives an "ACK" 
Cindicating ready to receivej» it may commence message 
transfer immediately. If the response is "NAK™ Cnot ready 
to receive)» the "“DLETENQ™” sequence may be repeated up to a 
retry Limit of “"n" ("%n™" being user specified)» and if no 
valid response is receiveds comaerce error recovery. If the 
system bicding for master status receives the “7"DLE“ENQ*" 
sequence Cindicating that the cther system is bidding at the 
Same time)» it abandons its own bid and replies tn 
accordance with its reediness to receivee In order to avoid 
eny line collisions when both systems are bidding at’ the 
same times» the nom~response time out values must be set to 
different values. This is true whether not the systems are 
"Like™ or “"unlike*. | 


Termination: | | 
The “*CLE-EOT" sequence is transasitted by the system directed 
to terminate to indicate the enc of its sessions and if 


using a switched Line» to disconrect the modem. 
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TRANSPISSTION CF PACKED DATA 


As 1n previous versions of this pretocol» data records within a 
message block are senarated by “RS" characters. Repeated 
occurrences of blank characters are compressed out using the 
"ESC-integer"™ mecharisme The method o f representing 
nonsprintable characters has changed with SYCOM's implementation. 
Printéebte characters are those Listec in “*Appendix 8» Character 
Set» with the exception of the “Line Feed" and "BELL" 
characters. 


If the data records contain only fprirtable characters» then the 
first character of the record “is not" a "DLE™ character. If the 
data record contains any character rect in the “character set™»s 
then the first character of the record must be a “"DLE“ character» 


and the remainder of the record contains translated data. The 
origiral data is translated such that every 4~bits is mapped into 
an 8~c-Cit printable charactere CActual data transmissions occur 


in ASCII charécter node.) 


NETWORK CONTROLLER 


The Network Controller provides interfaces with the User System's 
terminals and Server Systems at the hardware level. It 15 
” resporsible all for direct communicaticn with those terminals and 
(- Server Systems. It performs the actual data transmission (Cbcoth 
ieee transmitting and receiving) functiors between two systems. The 
Network Contrcller accepts data message blocks and system control 
messages from SYCOM end certain application programs Cprocram-to-~ 
program) and transmits them to the Server Systeme. In reverses it 
receives alt messages from a Server System and forwards them as 
required for handling control and distribution. The SYCOM 
program relies upon the MCP for the basic function of “message 
queuirg™ between it and the Nettwerk Controller and certain 
application programs. This facility provides the message paths 
between SYCQM» the SMCS» apolication programs» and the Network 
Contrcller. 


Following is a normal sequence of events which transpires between 
SYCOM» the Network Conrtroller» and the system's terminals: 


In response to a “poil™ by the Network Controller» a terminal 
transmits a message back to the Netwerk Contreller. The Network 
Contrciter accepts the message anc appends a header» supplying 


pertinent information about the messager Ceege» terminal type» 
isn» etc.) The Network Controller then determines which program 
to send this message to and writes it into the appropriate 
program's remote file Cinput queue). CAssume tn this case it is 
SYCOM.) SYCOM reads its remote file Cinput queue) and obtains an 
input message. Should the message be a SYCGM command» it as 
oo, processed and ge reply message createce The reply message is then 
=. Started down the line by SYCOM when it writes the output message 
. intc its remcte file te the Network Controtler-. The Controller 


BeibiitictDhll ibe ccd bailnin io cnesincaiee baits 


amet a — a 


 BURROLGHS CORPCRATION — - COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP > a ss B18007B1700 SYCOM 
SANTA BARBARA PLANT =~ Pe Se 2229 0458 CAD 


in turn reads the reoly message anc transmits it Cdevoid of 
header o f course) to the eeaSnee tiG terminal. 


rhe description on the eae oases of the SMCS eind: ‘ene Network 
Contrcller with SYCOM» which is alsc considered an application. 
progréms apply to any application prcgram. Thus» any application 
program can enjoy the benefits cf a sophisticated terminal 
Mmetwork with message/tergminal/program management thru the SMCS 
and Network Controller. In summations the SMCS is the message 
contrctler fer the systenr. It also prevides a amyriad of 
functions which direct Network Contrectler functions as well as 
speciel purpose NCP UREPORT 


CONFIGURATIONS AND SOFTWARE ASSOCIATIONS 


The Systems Communications Module has been designed to operate in 
either of three modes: 


Level 1) as an individual entity "without™ local terminals 
Level 2) as an individual entity “with” Ulccalt terminals 
Level 2) tn conjunction with the SMCSs alsc with terminals. 


keferring to Figures 4~5x» 476 and 477 Cwhich follow)» the system 
configurations with supporting software elements are shown and 
described. | | 


LEVEL 1 SYSTEM 


This system confiouration provides all of the SYCOM capabilities 
previcusly defined which includes the ODT as a virtual terminal. 
This ts accomplished with the smallest memory size commitment. 
Although the command repertoire is generally confined to entry 
from the system ODT» special application prograns running in the 
systew can alternately inject commancs to SYCOM for processing. 


In the User System schematic which follows (Figure 4-5)» the 
communication Links tetween system scftware elements are showne 
Each cf these Links» “queues™ and “remote files"» have specific 
purposes which are briefly identifiecac as follows: 


Ae "ING" is a queue file used by SYCOM as output to an 


application program utilizing the “Program~to7SYCOM™ 
facilities. | 


E. "OUTCG"™ is also a queue file useg by . SYCOM | as input from 


an application prograg utilizing the “"Program~to~SYC QM" 
facilities. 


C~ "LINK" is a remote file which 1s used in communications 
with a remote Server “hcst™ Systeme All RJE and 
virtual terminal input/cutput fessage traffic moves 
thru this file. This remcte file is directly retated 
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to the SYCOM communicatiors line to a remote host. 

Ce "RFUSER™ is a user definec name for aremote file used 

for program~to~program I/0 fessage traffic» primarily 

directly thru the Network Controtlers. All messages 


for this remcte file move thru the same communications 
Line as those identified fcr the "LINK® file. 
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Figure 4753 User System Schematic 
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‘LEVEL 2 SYSTEM 


This system configuration also prevides all SYCOM services as 


 outtired for the Level 1 System ard extends this to inciude alt 


local terminals. With terginals» SYCOM functions can be invoked 
from outside the computer room and eéway from the system ODT. 
Termirals on the system increase aemory usace in proportion to 


the number of terminals attached to the system and the line or 


Lines for terminals. The memory increase however» will be in the 
Network Controller program and not SYCOM itself. 


Local terminals are exclusively ownec and cortrolled by SYCOM. 
Although there is no ocperationat S¥CS required in a User System» 
It 1s "required” in a B1800 series Server System when Remote ODT 
type activities are needed. The introduction of terminais in 
this system requires another renote file declared in both SYCOM 
and the local Network Contrctler: : 


Ae "TERMINALS™ is the remote fite used by SYCQM for iocal 
terminal input/output messéege traffic between it and 
the Network Contreciter. As the cortrottler handles atl 
necessary terminal interfacing» SYCOM only reads input 
from and writes output to this remcte file. 
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LEVEL 3 SYSTEM 


Using this configuration» not only are all of the capabilities 
provided as outlined for both the Level 1 and Level 2 systems» it 
now provides the SYCOM terminal user with an access to ail of the 
capabilities afforded by the Supervisory Message Controt  Systen 
CSMCS). Memory increases in tkis configuration are directly 
related to the SMCS and the Network Centroller. 


Local terminals in this system configuration are under direct 
contrel cf the SMCS. Upon command CSMCS “sign on™)» a terminal 
%s terporarily “attached” tc SYCOM fer functional communications. 
kKhen this SYCO™M attachment is no loncer needed» the terminal is 
“detached” frem SYCOM by entering “<sscs signal character> OFF or 
oBYE™> This command is passed on tc the SMCS by the Network 
Controller which initiates the actual detachment and = again 
assumes controt of the terminal. As such» an additional terminal 
I/O tink 185 needed. Also» in adcittion to this link» SYCOM*s 
remote file “TERMINALS” is effected scmewhat. Both are described 
as follows: | 


he "“MCSREMCTE*" is a remote file used by the SMCS as a Link 


to the system's terminals. Ail terminat I/0 message 
traffic between SMCS and the Network Controiler passes 
thru this file. Durire the time a terminat is 


"*"signed™on™ to SYCOM» $certain messages are “switched” 
to the SMCS for processing (those messages prefixed 
with a SMCS “signal character"). 


Ee "TERFMINALS™ is SYCOM's rercte file for terminal inpout/. 
Cutput message traffic betneen it and the Controller. 
The slight difference being that terminal input/output 
only passes thru this fite for those terminals that are 
"signed~on™ to SYCOM. 
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MESSAGE PATH ASSIGNMENTS 


In order to describe the potential fessage communication paths 
opened up by the virtual terminal capability» a special message 
path syntax was develoned to pnictorialtly oresent this myriad of 
possititlities. The message path syrtax 3s easy to understand as 
one can visualize these togical paths thru the User and Server 
Systense System software elements are easily recognized by the 
widely used acronyms Cail defined tn the "*Glossary"™). Al though 
the directional flow arrows ““"->" indicate a single direction» 
comMunications are twortway. The bexed in syntactical elements to 
the right indicate an alternate message paths also available 
thru the “virtual terminal" capability. 


FOR THE LEVEL 1 SYSTEM 


COT input: | 

For this system level (Figure 3°9) there are three message 
Faths for ODT input. The fatloxing examples exptore each of 
these possibilities: 


User System ! Server System 


I 


, j ! 
GOT 78> MCP “=> SYCOM “we"> NC ‘=""== i 


i | / i 
! soa NC Seme> SYCUM 4 
i 
0o<XXX> ===> SYCOM i 
<XXX> eee Se SSeS SS ee > SYCOM ~--~> ODOT 


As shcwn in this diagram» all input command strings are given to 
User SYCCM by the MCP. Messages prefixed with a period ™.” are 


processed by User SYCOM. CThis pseudowmsignal character “." can 
be chéenged by using the “SIGNAL” comagand in SYCOM. It reverts 
back to the default ".">» or whatever was specified by the 


DEFAULTPSEUDOSIGNAL parameter» when the SYCOM user signs~off.) 
All cther input messages are sent to the Server System's SYCOM 
which will display them or that OOT. 
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then the “virtual terminat™ capability is invoked Cby using the 
".CONNECT™ cormand)» the following wessage paths are established: 


User System Server System 


=a ace = as =e op = a@ ee ow we ow oe ee ae ee ee 
-CONNECT <--> SYCOM 
ODT <--> MCP <--> SYCOM <---> NC ----- 
I / 
bP ween NC <---> SMCS 1 
o<XXX> oc---> SYCOM ! 
<XXX> 0 teeeeeee letaeattetattatetetetatanatatetataeteneta eo-------- => SMCS 
Z<XX> 0 seen eee eern ence es enn--- cerm--> SMCS <---> MCP 
2<nnn> sore cr scorn n- coo--- woeeeern-=> SMCS) ===> MCP 


The ‘SYCOM pseudotsignal character rust immediately follow the AX 
Without intervening blanks. Any rurecer of S&lanks Cinctluding 
zero) may» howevers» foltow the SYCOM pseudomsignal character. 
When e SMCS is running in the Server Systems the ODT operator can 
either "sign-on" to a program in that system or tnitiate RSC type 
commerdss thru the SMCS. When the virtual terminal is signed~on 
to the specified application orcaqrat» it is "*attached” to that 
progréeme Ail further nonwmprefixed input is sent to that prograrn 
for fprocessirga. CIn the exawrple below» the *$" character is 
assumed to be the Server System's SMCS “signal character”; it 
can te another character.) 


2 Stace cat sc a a Sa ea eS a ati ible asad abe eas RS Ei lnk Biinceind a at ibhaoon Se eave Ages Bereta Sedan an Bobaesitiensunke 
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| User System 1 Server Systea 
Pee aet re  g te eg Se ee te gD OM ee ey es ee One Beg a el Re ae Oe ee ee er ee a eee ee Pe ee 
- | oe et a 2. 
SIGN GN AP w"""> SYCOM 1 
i 


: a | : I 
UOT: =S> CP ==> <SyYCUOM =<S2>: NC Sa<=+ 7 i 
| i fo i 
! =sees- NC ===> AP 1 

i | \7> SMCS 1 


| -_ | ' 
e<XXX> ee===> SYCOM | 


$<CXXXD> pees ne een nnn ee nn ee ee nn nnn nnn ne nnn> SHES 
$Z<XX> 0 enone earner enn e anne nnn nenen---> SMCS ---> MEP 


$Z<nnn> sores renee enw e nese serena ==> SMCS "=> MCP 
; | 


Programto~SYCOM input: 
For “Program-“to~SYCOM™ communicétionss the folloaing message 
path assignments are avaiiable: 


User System 1 Server System 


m= SO eo ea ee ee ee oe oe avec none wae NOE Lem ee eee ee 


i 


(AP 0 weeeeeenten=>  SYCOM <---> NC --=-- ! 
| | / I 
men-- NC =---> SYCOM | 


o<XXX> see=> SYCOM i 
<XXX> we-=> SYCOM | 


Atl irput command strings are given to User SYCOM by the MCP via 
the “"OQUTQ™" queue. Messages that are prefixed with a period “.™ 
are processed by User SYCOM. 


When the “virtual terminal” capability is invoked (by entry of a 
"CONNECT" command)» the following message paths are established: 


a | | j | 4-278 | 
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User System |] server System 
aoeweweanmaedawna esas ean a Suna aen awweaeaa eee ee auaananunaw fatwa es awe <2 = on ae U2 a GD aw an a an = oe a 
] 
eCONNECT <--> SYCOM i 
| i 
I 1 
AP 0 seen cerree= => SYCOM <=""> NC =s9== 
1 / I 
w---- NC <---> SMCS I 


~ 
DS we eeeeed FBP eee SOO SBB aD we Fw ee ee ee ew ee ee ee 


e<XXX> ose==> SYCOM ! 

KCXXX> 0 Teese tee reenenenee= ce--- wocece---- weee---> SMCS 
ZEXX> 0 sweeten ewer ener essene-n- e----> SMCS <--"> MCP 
2<0nhe SSSseSsSseseseseSse= saSegeeer=> SHCS. er > MEP 


Wher 2g SMCS 1s running in the Server System» this program can 
*signton™ to a program in that syster or initiate RSC commandss 
thru the SMCS. When this virtual terminal Cprogram) signson to 
a specific application program» 7t becomes “attached”. AUt 
nonprefixed irput is sent to that Server program for processing. 
Cin the example below» the “$" is assumed as the Server System's 


C SMCS “signal character™> it could te somethirg else.) 
User System 1 Server Systea 
—a ewe ee eS eee ee ee eee ee ee ee 2 ee ee ee Seana naman eweas ewe ea naw fp, eas ae ae maaan ese ae ewaew ae 2 Gb «ap an © 
i 
SIGN ON AP wt3r"> SYCOM { 
I 
l i 
AP 22S ese = eSe=> “SYCOM. ~s"">. NG ss=S= i 
{ / i 
J seme “NC. “swe > AP { 
1 \e7> SMCS 1 
I 
o<XXX> se"=> SYCOM 1 
CAXX> SSR eer See Soe eae Sear Se nee ere asses > AP 
ECXXXD teem ete ese e sewn e sens cece sere cereeesene> SMCS 
EZKXXD tre eae ent nn wn een aa slasheeatenerastadan > SMCS <---> MCP 


TZANNS Sere Ste SSS eS SS eS SSeS SS > SMCS -Se=>° MCP 


B1800/B1700 SYCOM 


Peactaasee-pccorse input: 7 So 
The message path for program=to-~ program communications 1s 
limited to the following precetermined pathe Messages can 


te any format and contain agny text agreed upon by both 


epplLicaticn programs. The only rrevailing restrictions are 


faximun “buffersize™ and ail Bessages must de prefixed with 


a “header™ C"Appendix E"™). 


User Systenr j Server System 


mew we ee eee ee oe 7 2 oh 2 Oe On SE OD ee Oe Oe ee ee ee ee eee ee ee ee ee asneae, eas eae wee wee we ee eee ee 


CXXX> teen ce ee renee --- re ee nnn n=-=> AP 


t 


FOR TFE LEVEL 2 SYSTEM 


In this conficquration (Figure 37-6)» the ODT and alt terminals 
attached to» and owned by» SYCOM normally communicate with local 
SYCOM. When the virtual terminal capability is utilized» these 
devices are permitted to communicate with either the system 
software programs or appropriate application programs in a Server 
Systeme | 


The OCT» programmto7SYCOM» and precrammto-program input message 
paths for this software configuraticn are the same as those 
defined for the “Level 1! Syster"™. The following message path 
assigrments are for Local terminals éettached to this system: 


User System ! Server System 


| 
VOT <=> NC “--> SYCOM 


°<XXX> ===> SYCOM 


ee ae ee ee 


By entry of the “.CONNECT™ command tec SYCOM the virtual terminal 
capability is invoked. The fottloawing message paths are then 
established fer the termirals: 
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eCONNECT <--"=> SYCOM I 
i i 
VOT -*> NC ==> SYCOM c=""> NC see-- 
I / 
1 ese NC <---> SMCS 1 
! 
o<XXX> =2-"> SYCOM I 
<XXX> 0 teeteen oer emereercrecse- coon eo- ecereoe-- “=> SMCS 
Z<XX> 0 Bem mete emer ones reeereeesree=> «=6SMCS = --> MCP 
Z<NNN> emt t ett sete enn er ers ss essen = > SMCS --~> MCP 


Wher 2 SMCS is running in the Server System» the terminal user 
can either “signton™ to a program in that system or initiate RSC 
type commandss thru the SMCS. When a virtual terminal signson 
to. a specified application oorcgrém@s» it is “attached” to that 
programe Alt further nonwprefixed input is sent to that program 
for processirg. CIn the exaacle Fellow» the "$5" character is 
assumed to be the Server System’s SMCS “signal character", it 
could be another character.) 


User System 1! Server System 


eeweweewe was = -— - =< om — a. = oe Ss Q eee ean eee ee La sa see wesw nase eB ee eee eee 
i 
| 


VDT <*> NC =-> SYCOM --""> NC <----- 


i eases NC -ra=>. AP 
j \7> SMCS 


e<XXX> ce-—> SYCO™M 1 
<XXX> Sane ee Cee ewe eee ee eee eee ee eee ee => AP 


TL KK SSMS S sees SS eee ee eee SMCS USERS MCE 
LL500h2 SSeS 4 22 SSS eS See eee eS SMCS “P= => MCP 
! 


ee ee ee - Spt ee ee ieee — 
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FOR TRE LEVEL 3 SYSTEM 


In this configuration (Figure 3-7)» all tocal terminals are 
attached to» and owned by the SMCS. Therefore» the normal 
message communication path is to the User System's SMCS. When 


the virtual termiral capability is utilized» these terminals are 
permitted to coamunicate with either system software programs or 
appropriate application programs in the Server System. 
Additionally» these same terminals are permitted to communicate 
with eny appropriate application program in the User System. 


The OCT» Program~to~mSYCOM» and Proacram=to-Program input message 
paths for this software conficuréetion are the same as those 
defined for the “Level 1 System™. The foltcwing message path 
assignments are for all tocal terminals attached to the User 
System's SMCS. First the normal message paths for terminal input 
within the User System are presented: 


User System 4 Server System — 
= eo 1 we oh ae ae OS a ee me a 8 an a eo a Oe ae St Ge ee ee ee oe 2 oe ee ee ee ee ee oe oe —_ ef. an we ae ee ae een a on sa oe ee a Oe ee ee Oe ee ee ee ee ee 
1 
VOT <--> NC “=> SMCS 


<XXX>  ce==> SMCS 
Z<XX> samen > SMCS ==> = 6MCP 
2Z<nnn> seem > SMCS ==> MCP 


In order for the terminal user to géin access to a SYCOM system» 
one of two access methods must De useds 1) By using the betow 
SMCS "SIGN ON*™ command procedures» cr 2) By utilizing the method 
wherety each command is *PASStd™ toa SYCOM via the SMCSs it is up 
to the user. CAlthough this example is for a sign=on to SYCOM>» 
it cculd be any apprepriate applicétion program itn the User 
System.) 


! 
SIGN ON SYCOM <seernmm=> SMCS l 


The fcllowing message path assignwents are then in effect for ail 
terminal input. 
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| | | 

YOT ==> NC *-""> SYCOM -<-=-=> ‘Cc --«<-= j 

\-> SMCS | / | 

GS sie ia e NC "=> SYCOM i] 


o<XXX> eee > SYCO™M 1 
<XXX> ese=n=> § SYCUM 


2<XXX> eeee--> SMCS | 
*Z<XX> seer > SMCS a MCP | 
aZ<nnn> cteenret> SMCS => MCP i 

I 


The “virtual terminal” capability is invoked when the terminal 
user enters the “.CONNECT™ command tc SYCOM. Following are the 
messagce paths now established for the terminats jf a SMCS is not 
currertly running in the Server syste: 


User System 


eCONNECT w=-=> SYCOM 


VOT <--> NC "=> SYCOM -<""> NC coH=- i 
\-> SMCS i / i 
bo een NC 

o<XXX> os-"=> SYCOM 


<XXX> =s==> SYCOM 

2<XXX> f2-—> SMCS | 

aZEXX> e2r-—-> SMCS --> MCP } 

aZ<nnn> s777> 8 SMCS ==> 9MCP } 
1 


When there is 2 SMCS currently cunnicrg in the Server Systems» then 
the following message paths are established for a terminal: 
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I : 

: = 

VOT <--> NC =="=> SYCOM <---> NC semen | 

\-> SMCS .g 

w---- NC ----> sMcs | 


e<XXX> oo e"-> © SYCOM | 
<X¥X> ee et ee ne eee gee te ge ge ee eee SMCS 
eeyys oe ew ee eww em ee meres eeee=> = 6SMCS <=> = = 6MCP 
7<nnn> aesuaneanawewecoa wea eee es eo eee ew) SMCS 7 MCP 
a<XXX> cee-> SMCS 7 1 oe | 
a#Z7<EXX> fFe-=--> SCS “~> MCP I 
#aZ<€nnn> «*7"> SMCS ==> MCP i 

j 


With the SMCS running in the Server System» a terminal user can 
either “sign=on" to a program in that system or initiate RSC type 
commands; thru the SMCS. When a virtual terminal is signed=on 
to 6 specified applicaticn orcaréerse it is “attached” to that 
program until the terminat user “sigrsof f*. ALL non~prefixed 
input is . sent to that application program fer processing. CIn 
the examples bellows» the “*" character is assumed to be the User 
System's SMCS “signal character” and the “8$"* character 1s assumed 
to te the Server System's SNCS "signel character”™> they can be 
different.) 


User System 1 Server System 


= a an 4 aw a ae oe 28 ae oe oe 2 en ae OS ow OE OS GE OE Oe oe 8 ee ee OD ee ee ee ee oe ee eee, ee a ee ee ee ee 
| i 
SiLGN ON AP SSeS 8$62 93233533235 +SsS ee eso ne sae ==> SMCS 
1 
| ] 
VOT ==> NC: <$“=<=> SYCOM <==S=> NO ==="= i 
. \=> SMCS i / i 
i. ssene “NC soe): AP ] 
i \m> SMCS i 
| 
a SXXXD> Oteewnmn> SYCOM | | 
B<XXX> seerne-> SMCS | 
aZEXX> coem=> SCS “=> MCP ! 
aZennn> ss3-s> SCS o=w> WMCP | 
<XXX> SMASH A SON AT SSSR > AP 
$<XXX> Pewee owners ee em esaTe ame asaeeenmmee> SMCS 


$Z<nnn> -eoe nen nnn n nnn n nena nn nnnn-=> SMCS <=> MCP 
j 
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QUEUE DEPTH CONTROL 


In the SYCOM operational environments» there 1s a MCP controlled 
data path which exists between SYCOM and the Network Controller. 
This data péth is referreo to as the “remote file” Cor message 


queue) mechanism. Due to differences tn data communication line 
transfission rates and peripheral irput speeds» this remote file 
becomes a buffer. Without some kinc of control on the message 


traffic thru this file» it could crew teyond reasonable Limits or 
be jammec full. 


To previde a control cver the number cf message blocks that can 
be cueued up in this file at any given time» a “marker message" 
system 1s employed.» As SYCOM 153 putting messace blocks into this 
files a count 18s maintained. Wher this count reaches the halfway 
point of the Gqueue depth Limit» a marker message is put into the 
file. The marker message 1s a specially prepared data message 
with ¢ code in the message header. This special code ensures 
reccoenrition by SYCOM ane ‘this messace is echoed back to from the 
Network Contrcller. 


Once a marker message is placed into the file» SYCOM continues 
putting message blocks irto the file until the predetermined 
queue depth Limit is reached» at which time peripheral input 
operations are suspendede When the Network Ccntroiler encounters 
the mérker message during the trarsmisston of the queued message 
blocks» it acknowledges receipt of a marker sessage by returning 
a "fléeg™ in the corresponding “ACK” sessage te SYCOM. When SYCOM 
receives this ecknowledgements» it resuffes peripheral input» again 
places a marker message into the file and continues putting 
message tlocks into the file until the queue Limit is reached or 
until an endwof-file conditions whichever occurs first. 


The current values of the “aueue size» and it associated 
markertoffset» may be queried cr changed with the "QS" command 
durinc executions or with the “GQUEUESIZE" parameter during 
startup. 


SYSTEM FILES 


In the total system pictures there are many files and file types. 
However» as this system overview pertains only to SYCOM and its 
relationships» onty those pertinent files which are required for 
SYCOQ™M operations are presented. Following are file descriptions» 
by software element» that are necessary for SYCOM operations: 
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MASTER CONTROL PROGRAM CMCP) FILES 


 CSYSTEM)/USERCODE File 


This file contains all valid usercoce"passwords that are known to 
the system. It 1s used by the MCP to enforce file security disk 
files and procrams/users that access them. With this file» the 
MCP cén service ary requests by programs regarding vatidity of 


specific usercode"password combinations. CThis file is only 


required when the system is overating with “usercodes™.) 
NETWCRK CONTRCLLER FILES 


Network Information CNIF) File 


This file contains tables that descrite the physical and Logical 
attritutes of the network. The initialization vatues for tines» 
termirnats» and file tables of Network Controller are contained in 
this fiie. This file is created by the NDL compiler when it is 
in the process of generating a Network Controttler. 


SYCOM FILES 


The Systems Communications Module utilizes many types of files in 
the @®anagement of its domain. There are» peripheral Cincludes 
disk)» remote communications» and cueue files. These files are 
briefly described heres under serparate headingss with detail 
descriptions for majcr files available in, the appendices. 


Peripheral Files 


These files are generally used tao ingut/output RJE type data and 
include the card reader» card punchs line printers magnetic taper 
and disk files. Also there is a disk file which is used by SYCOM 
to menage the various options ard settirgse Following are 
general descriptions of the. SYCOM files which fati into this 
categcry: | 


Aw PARAMETERS Eile 


The PARAMETERS file ts a single record file containing 
required operational parameters for SYCOM. It is static 
and can onty be changed by removal and recreation. This 
file is created by SYCOM upcen the entry of approvriate 
Parameters from either disk» card reader» or User ODT. 


(B. NEWPARAMS File 
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menses 


The “SYCOM/NEWPARAMS” file» on disk or cards» can be 
used to create the “SYCOM/PARAMETERS" file in ovreference 
to entering the “paraneters™ manuatly from the ODT. 
This file can be created using CANDE or any other 
supported text/editor progrém and is freenformat,s 
explanatory comments may or may not be included in the 
file. 


Card Input Eale 


This file is used to input RJE card data files from the 


System's card reader. It can be either a 80~-column or. 


96ecolumn device or a diskfiles However» in the case of 
the 9E€~column card readers» cra diskfilte only the first 
90 columns are processed. 


Card Qutout File 


This file ts used to punch RJE card cutput data files to 
the system's card punche It can be either a 80-column 
or 96*colufn davice» as aporcpriate. 


Printer Eile Coptional) 


This file ts used to print att RJE print files that are 
being» or have beens received from a Server Systeme. The 
Line printer device can by gery one cf the various medels 
that can be attached to the systems which can be either 
a 120°-position or 132-position tine printer. If no 
printer is availabler the printer-backup files may be 
transmitted to a “remote system™ which has a printer. 


There is an additional prirt file which is used to List 
SYCOM's "TRACE™ or “QLDIFACE™ files via the *.LIST” 
commends it does not irterfere with printing the RJE 
type print files received Ey SYCOM. 


Remote Files 


The remote files are used in communications between SYCOM and the 
Network Controller and SYCOM and either the terminals oor SMCS. 
There are two cf these files which are described as follows: 


A. 


LINK File 


The "LINK" file ais usec for all input/output messages 
relating to RJE and file transfers» specifically» 
Station types for Control» OCT CSPO)» Cards» Printer» 
and File records. 
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£. TERMINALS Eile 


The “TERMINALS” file is the communication Link between 
SYCOM and the Network Centrolier for local terminal 
messagese This remote fite is however» only used when 
there are tocal terminals; controlled by either the 
SMCS cr SYCOM. | - | 


“Queue Files 


The cueue files are utilized by SYCOM for buffered communications 
between itself» the MCP» and the Netrork Controller. The purpose 
of egch of these queues is describec as follcws: 


Ae RIE Gueue 


Used to save printer/punch cata received from the other 
system when the User System's printer or punch 1s bDusye 


E- LINK Queue 
1. Used to save input wessages from the other system 


curing the “*initializaticn™ phases eise they may 
be lost. . 


2e- Used te save output sessages for the other system 
when “messages queued” exceeds “MAX=MESSAGES*”. 


C. INQ Sueue 


This queue 3s the mechanism by which SYCOM sends reply 
messaces to an applicaticn program cealing in program- 
to~SYCOM communicationse SYCOM *"writes”™ into it and the 
application program “reads” from it to obtain messagese — 


Ce CUTS fueue 


This queue 1s the mechanism whereby SYCOM receives tnput 
command messages from an anrglication program that deals 
in program~to~SYCOM commurications. The application 
program “writes” into it anc SYCOM “reads” from it to 
obtain input messages. | 


RESTRICTIONS 


The following restrictions are valid for the system based on a 
Logicel evaluétion of the system's requirements: 


- Maximum message block size = 1950 bytes 


- Mininum message block size = 262 bytes 
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« Maximum simultaneous system ccrnnections = 1 
- Maximu® message block aueue depth = 255 
« Maximum number of file transfers queued to process = 99 


- Maximut® number of terminals supported = 15 


i 
pus 


- Maximum number of card reacers supported 


UN 
pub 


- Maximum number of card punches supported 
e Maximum number of Line printers supported = 1 
« Neither CLCAD.-DUMP or SYSTEM/CCPY tapes are supported for 


file transfer operationse 


- Only “data type fites™*™ are file transferable between 
disk/tape and tape/disk Ccodes files are invalid). {Only 
one data file per tape is altcwed.) 


- 920 type files» i.@e» type > 15» are not supported “for 
file transfers. | 


« Multiwmpoint networks ara not supported by SYCOMs at this 
time. | 


-« Message blocking 1s prohibited. CA message block already 
contains multiple records cr cata images.) 


e Monitoring and controlling of programs in the Server System 
requires a MCS executing in that systemre 


» This system does not support *"binary~synchronous®™ 
communicationse 


These restrictions may be changed during subsequent development 
cycles» but are however» currently ir effect. 
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OPERATOR COMMANDS 


GENERAL 


The set of commands described tn the section is used to direct 
the System Communications Mcdule (CSYCOM) program operations from 
either the Cperator Disptay Termirat CODT)»> a remote operator 
displsy terminal Cremote ODT)» ¢ system terminal» or anes 
application program running in the system. 


Non=SYCOM program commands are also permitted to direct. 


user =system and serverwsystem operations by way of respective 
SMCS "*s. 


A rewrote ODT station is astaticn that is known to SMCS as a 
remote ODOT station anc is defined in the netwerk controller with 
a transmit frequency greater than 24S. | 


A workstation is a station that is known to SMCS as a workstation 
or controller station and is defined in the network controlter 
with @ transmit frequency Less than cr equal to 249. 


Table 4-1 at the end of this section contains a summary of all 
the SYCOM commands available in the SYCOM program. 


INPUT COMMANDS 


Each statement in the Command Language consists of a command and» 
in some casess a list of parameters» The parameters in the list 
are separated from the command and each other by blanks. In the 
following exanrples single sfaces are used although the use of 
muttiple spaces between command elemerts could be used. 


When the SYCOM has finished processirg a commands it displays a 
reply message either confirmirg successful completion of the 
command or tndicating an error. Errors terminate the processing 
of a conmand>, the entire command must be rewentered correctly 
Cexcert for commands which allow multiple operands such as 
»LIST). 
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COMMAND SYNTAX CONVENTIONS 


The rotation conventions that are described below are used 
throughout this section to describe the syntax of each command. 


Notation used in model format 


First» a model of a ccmmand is oresertede This gives the user an 
overview of the potential of the ccraand structure. 


eCCPY <filernamer1> CCUSER=<userccce>))] [“e27"7> AS @=2t°°-- -> 
1--> ONTO ==>! 


e--> <fite-name-2>] FROM CHOST=<id>) TO CHOST=<id>) ---->% 


BRACKETS: 
Information that is enclosed within brackets [1] represents 
an option which way be used or cmitted by the user. In the 


model exzrple given above» the cpotions USER» AS or ONTO» and 
™"filesnamer2" indicate three pcssibte choices when using 
these options» or the choice af not using any optione 


BROKEN BRACKETS: 

Left and right broken <> brackets are used to indicate that 
the enclosed variable within the brackets must be replaced 
ty digits and/or tetters whose value is determined by the 
context of the command. 


UPPER CASE LETTERS: 

Kords that appear in upper case letters indicate that the 
word 1s a lLliterat and must be substituted verbatim» when 
used. In the model given above» the word -COPY would be 
entered first when constructinec ¢ command statement. 


LOWER CASE LETTERS: 

hords that appear in tower case letters indicate that a 
value must be supplied. In the model abover the word 
"filesname~1" Indicates that a character string representing 
the name cf the fite toa be copied must be entered. COMMAND 
STRING SYNTAX CONTINUATION: A few of the commands have a 
considerable number of syntactical itens which overflow a 
printed line into two or more command string lines in the 
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presentatione To provide a clear tine cf continuation for 
the command string» the use of Line direction arrows are 
used. A line direction arrow érpears as “""""> and always 


flows left to rights to contirue the command stringe It is 
@asy to follow @ command string in this format as it is 
togical in nature. | , 


CPEN“CLOSE PARENTHESES ()s 

When these characters appear in acowmand syntax statement 
they are required input. See the *"COPY™ command for a _ use 
reference. 7 


SLASH 7/5 7 7 | 

kKhen this character appears in &@ command syntax statement it 
is required inpute A space or spaces on either side of this 
character are not allowed. 


END OF STATEMENT? 

The end of a command statement is indicated by the 
appearance cof a % Cpercenrt sigr). It is a syntactical 
string terminator but is only reaquired if commentary text is 
inctuded in the command inpute 


Punctuation Rules 


The space» the comma» and the pericd are corsidered punctuation 
marks Cexcept in titerats) and are usec as follows: 


1s The space Ctlank) is a separators recquired after words 
and literats in the absence of any cther separator. A 
Space may precede or follow any other separators and 
many speces are the same as cne Cexcenot in literals). 


Ze A comma is a separator that is Legal only where it is 
specifically indicated ir the command syntax. The 
cOmma» where it i18 legal» can aiso serve as a 
terminator for words and rumeric titerals. The comma 
1s never required» except tc separate criteria in a 
command string. 


3% The period is a reauired prefix to local SYCOM 
commands. It is never recuired within any command 
string syntax. Its only acceptability would be as an 


embedded character in a file name» system identifier» 
or usercode/password. 


Commerts 
le SYCCM commands and/or operands may be entered in either 
upper or tcwer case. File-rames» however» must appear 
exactly as recorded in the system disk directory. No 


translation will occur. Currently any quete marks that 
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COMMAND RELATED ERROR MESSAGES 
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string wilt be taken 
{°c start a guoteg 


special character ‘“»"™ 


Error messages specific to the follcning SYCOM commands appear in 
Appendix A (Comeand Error Messages). 
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ABORT 


The AEQRT command causes the SYCOM peregranm te abort an in=process 
file transfer or a scheduled file trarsfer. : 


Syntax: 


eABLR Tee 9--- CONNECT ------- oe an ae en ene == --------- Jacneanancue wee > 
{~~ FETCH =~] I-=- <schedule nuwrber> -~! | | 


I=" PUT --9-1 Jom teen nee eenene n=] 


> —2 7 =e we oe ee 2 =p ae a a ee oe ae Se ae a 2 ee ee ee ee ema eS ae oe = / a eo om a oa swe eee eee ewe eee ee oe | 


d=~ 242 <comments> =i 
Semantics: 


CONNECT Causes a schedulec connect to be removed from 
the schedule. Connects will only be 
scheduled when the remote system is off line. 


FETCH Causes the tnwprocess file transfer initiated 
by the FETCH coward to be aborted. The file 
being received 1s not saved. 


PUT Causes the inwprccess file transfer initiated NP 
by the PUT command to be aborted. 


schedule number — Identifies the file in the fite transfer 
schedule to be sterted.e If the field is left 
blank» the FETCH cr PUT cperation in process 
is aborted Cif ary). 


= Aborts the inwprocess file transfer and ail 
files scheauied to be transferred- The equal 
sign (C=) character must follow PUT or FETCH. 
ABORT FETCH = or ABORT PUT = as only valid 
from the system CCT. 


: ss bai ey Side ties be ge SN hel tron a BE ete as ells wade A nnn irtdol d e iota ely? oy yy ca od RD ft So 


276 


BURROLGHS CORPCRATION COMPANY CONFIDENTIAL 
COMPLTER SYSTEMS GROUP B1800/51700 SYCOM 
SANTA BARBARA PLANT Pe Se 2219 0458 CA) 


Examptless 


2eABCRT FETCH 


x 


Atcrts the file trarsfer ir process which was 
Z initiated by a FETCH command. 


eABCKT PUT % Aborts the file trarsfer ir process which was 
Z initiated by a PUT command. 

eASICKT FETCH 4 Z% Aborts the file transfers» schedule number 4 

% in the PUTQUEUE cf the remote systems whether 

%Z in process or not. 


eABCFKT PUT 190 % Aborts the file transfere schedule number 10 
2 in the PUTQUEUE cf the local systems» whether 
Z in process or note | 

eABCRT FETCH = 2% Aborts atl file transfers tn the PUTQUEUE of 

Z the remote system end the in process file 

Z transfer Cif any) which was initiated by a 

% FETCH command. 

eABCRT PUT = Z Aborts att file transfers in the PUTQUEUE of 

% the Local system and the in process file 

2 transfer Cif any) which was initiated by a 

Z PUT command. 


The SYCOM message PUT REQUESTOR MISMATCH can occur if the user 
attempts to abort a PUT or FETCH operation of a file andthe 
source file was secured with a userccde/passworde 


Any one of the fottowing conditions aust exist to initiate a file 
transfer of a secured file. 


1. The user must be togqged or to the SMCS With a 
usercode/password and enter the PUT or FETCH command to the 
SYCOM pregram through the PASS ccmmand te the SMCS. 


Examples: 


PASS SYCOM PUT <filename> 
PASS SYCQ™ FETCH <filename> 


Ze The user must be lLogged-on to the SYCOM program by entering 
the US command to the prograne 


Examples 
US = USER/JONES 
36 The user must assign a usercode/fassword to the source file 


when a CCPY» PUT» or FETCH SYCOM command 1s entered to the 
SYCOM orccram. | | 
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Examples: — 


ePUT MASTER CUS = DOE/JCHN) 
eFETCH FILEA (US = USER/PAUL) | 
-COPY SOURCE CUS = DDT) FROM CHOST = 81800) 


ssletthes o 6s acca iaatpnaee cack union Cass ous pec at aga mca esc So hm Do rg aL a a ees ag ee ae Sed aed 
Hecabtabetsunlt cx, gndaite dat mk de Sites Noemie sence aed iOSpe welini ibe Boatheahe se teo aCe ~s ao Lik SSS ha Se RE ark Sa le Bate eee at dh icant bait ior wate Nila oC 


BURROLGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1800/B1700 SYCOM 
SANTA BARBARA PLANT a Pe Se 2219 0458 CA) 
ADD 

The ADC command causes the SYCOM program to initiate a file 
transfere The command syntax provices for the transfer of files 
from the initiating systen to ancther system and from another 
system tao the initiating system. Tre files can be in either 


Magnetic tape or disk form. The file transfer witt be aborted if 
the destination file exists at the receiving system. 


Syntax: 
eADD <filename~1> sa senate tn ean ea a wae aaa Nena eee eae naw unan awe eee 
I 
i (C2 seor == e SSS SSS 23S eeS Seo == 1 
I |. | 
co Pm- ( werenwnns 1 Jem <usercode part> =~ ) 
i 1 
Pnn/ 1 feceereernnn- LIST <1 
f Pas NUS] I 
j I 
l--/ 1 foo----- REMOVE ----- ! 
bo-/ 1 feeocen- SAVE won H-] 
I--/ 1 force SKIP <n> ---1 
l--/ 1 fe----- FILE -------1 
>wawveanen ae ewae BOM ROE TSF BOR SOR SBE TB REBT EBT EES |e e 2 2 on a om oD =o on ae a a om oe 


“5-8 


sam we oe oe > 


I- BINARY <1 I- AS “-= <filenamet2> ~1 Im C<usercode part>) =] 
| i J 
{Se=<S3> 4 S==-== 1 
> wee eee rere receen-= oe enn enn ecw en nnn wenn se ee secre =-- sone ee--- B 
] 
P=e=" FRO Sse => SsS—- <== SS Si << s6S Ses oS See SSS = esa =e A 
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[ <eceree---- a dela p Tt w enemas essessesssess 1 
| ee | | | a: 
ASS 0. Seeess/ 4 f= SsS=. KIND. f=). Pe se3 215K “Sams ese=seSs 9. SeSeseo™ 
| a eer 3 ge PACK Mb Td 
1 | I ter TAPE... <=) 31 
i ot I-- TAPE? "i 1 1 
I 4 I-- TAPES w-l 1 1 
I ; | I-- PETAPE --!I 1 1 
I I 11 
i i=== DIS -Se<se=se> aimiaieiaee =s<ss= | 
l | ! 
f=7 2. /=== HOST f=] <systexcid=i> -<<<<-=-=1 
§ eam cern ens enews asa aeana- TO a ne salenhnhatacenteahecheietaatetatetebaraae D 
i ; : 
1SS= 1G, SeSes=sessaeSsesessSe se Sessa Ssss= esses ose = SaaS. “C 
l--- <volume-2> ---1 forn- 0 
16 eSr SSS ess ese es ; ae ese eS SSeS ss=— alee aa act ! 
! 
a aa ft foeese= KIND i=) @ess= DISK. =Seeree= Seas 2. Geese) 
i i I-- PACK --! 11 
; l-- TAPE wm! 7.1 
1 I I-- TAPE7 --1 1 1 
i i l-- TAPES <--!I 1 1 
! I fe=PETAPE “21 << 4 
i 1 1 
I poss. DISK. “=s=== ae aad) 
1 ! 
i I 


“e/ 21 f/me" HOST C=] <systemmide2> sercrere-= 


f-- Z <comments> =! 


The <usercode part> syntax is shcwr in the following syntax 
diagréeme 


USLER] [=] --"9- <usercode> To ttt ste sr cers n tsetse ree seen sen ener see--|] 


i l--- » PASSWORD [=] <password> ~---] 
| { 
Im-~- <usercode>/<passnord> wsetc3reetrt. cece enon wana we | 
semantics: 
AS Informs the serveresystem tc create a new file 


with the name specified as filename-2. If the 
file is present on the server-system»s the command 


seSehexonsp as ghbe Soe satin’ nei a i aah ual ste een ih eet ht ast aati hi Sh Si ag N an lle Ba Se anes Sane Fe es soi ie HE doe 
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BINARY 


FILE 


filenagme~1 


fileneme-2 


KIND 


LIST 


1s aborted. 


Applies to data files and causes the SYCOM program 
to expand all the records in a file prior to 
transmissitone Code tiles are always expanded. 
The BINARY option atlows users to transfer files 
to and from an ASCII systeme. If the BINARY option 
is not specified fcr a data file transfer to a 
non=EBCDIC systems the SYCOM program changes 
non"graphic characters to question mark (7?) 
characters. The graghic character set 1s_ the 
EBCDIC representation of the 95 valid ASCII 
characters and the null character. 


If a data file is sent to a CMS system CASCTII 
machine) with the BINARY option specified» to 
retrteve the same file and maintain file 
integrity» the ADD ccsrand must tnclude the BINARY 
opticn. 


Allows SYCOM to read the names of the fite€s) to 
be transmitted from the files <filename~1>. By 
using the FILE options a sertes of files can 
transmitted by one ACD statement. Each filename 
must be entered on separate reccrds in the fite. 
If the destination filename is to be different 
than the source filerdrer it is entered following 
the source filename separated by at least one 
blank. Comments can follow the Last filename on 
the record starting with a percent sign ("2"). 


specifies the name of the file to be transmitted. 
The filename can be a single file or a family of 
files tn the formats “<multifile"id>"/=. 


Assigns the name tc be given to the file on the 
destination system. The filename can be a single 
file or a fasily cf files in the format: 
"<mulcifile-1d>"/=. 


KIND is a keyword which is used to describ2_ the 
peripheral device cf <2 file. The KIND keyword is 
not required if the file is on disk. 


Informs the receiving system that the printer 
backup file is to be printed after transmission by 
Zipping a command to the SYSTEM/BACKUP program if 
the MCP autobackup option is sete | 


oat sabia onbalcSiM ahaank s tisie at Ae wat Cesc ala ae USMS Ep were Seer don ee 
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systemmid-1 


systemmid-2 


volume=i 


volume~2 


Examples: 


2eADD XYZ CUS=US/PASS) FROM COISK» HOST=USER1) TO CDISK» HOST=SERVER1) 


— COMPUTER SYSTEMS GROUP | = ae B1800/B81700 SYCOM 
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NO Overrides the dodawie LIST ates bate and is” ont y 
valid for printer backup files. | 

REMOVE Causes the file tc be removed from the sending 
System after the transfer has been completed. 
REMGVE is the default fcr printer backup files. 

SAVE Ensures that a printer backup file is saved after 
the file is transferred on the sending system. 
SAVE is the default fer non-printer backup § fite 
transfere | 

SKIP <n> Specifies how mary files to skip if the "ADD 


<multifile-id>/=" or the indirect CFILE) option is 
usede The first “<n>" files of the family are 
skipped. Usage of the keyword is optional. | 


Specifies the system identification of the System 
from which the file is to be transferred trom. 


Specifies the system icentification of the system 
that is to receive the file. 


Identifies the user fcr the purpose of verifying 
access rights to the specified filename. 


Specifies the oack~ic or taperid for the source 


file. This option is not required for files on 
the system disks cr’ af a packwid appears in 
<filename"1>.- "DISK" is used to indicate the 


System disk. 


Specifies the pack-id or tape-id for the 
destination filee This option is not required for 
files on the system cisk» or if a packmid appears 
in <filename-2>. 


Parentheses are key characters when using a US» NO 
LIST» REMOVE» or SAVE option. The options can 
appear in any crder within the parentheses. 


Assigns the filenafe specified in filename~1 to 
filename2. 


eADD DMPALL AS DUMPALL FROM CHOST=FLE» KIND=TAPE) 


eADD SDL/= 


AS SOLNEW/= FROM CHOST=HU8) ; 


eADD RELEASE CFILE» NO LIST) TO CHOST=HUB) 
eADD = CUS A/B» SKIP 123) TO CHOST=USER3) 
eACC RELEASE CFILE» SKIP 9) TO CHOST=USER5) 


cee ce ape ge een mane Sees ge ee a cee te ge RN ye cara gt SME EGE OG th coe i te ena dee sa lahah Bata ay Saag aay ane BA agin oy ag '3 Leman cielo Lad aati a oat Sa! ahd «nd pettus 
dean eb teh FSmenldevelel ii jh sieuieets ash hateatbot Po ae ro ies ra tpg rie geet oom tte a Boa hie esas cs toa data taehis 8 atet seastetasds Seba edna See ath gad, tertiles oie sit Aas Be diab wi 
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Examples one and two are examples of single file transfer. 
Exampie three is an example of a trersfer of a family cf files 
and example fcur is an example of usira a List of files to effect 
a trarsfere Example five is an exaaple of using the SKIP option 
when transmitting a family of files. Example six is an example 
of using a list of files with the SKIP option. 


: ee ey ee ae cot ee ea fe a rn hale a rg at pees a 4 ‘g fear Pet dirsctie pan nom PR a I inter ete ets Fe ee” eS 
nS tlh Sie tek sane apne ee spt t aSartennei te seme oe rae a — Sa a a a aR RS ETS al 
“ Scene. aA ST ; —_ ‘ 
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BUFFER 
The BUFFER command causes the SsYCO™ program to. change or 
interrogate the buffer size for sending file transfers. The 
buffer size is specified tn bytes. The minimum buffer size is 


362 bytes and the maximum is 1950 bytese If the BUFFER parameter 
is not specified in the parameters file» the buffer size defaults 
to 1950 bytes. | 


The receiving tuffer size is always 1950 bytes. 


If the buffer size is changed with the BUFFER commands the new 
value is effective until another SUFFER command is entered or the 
SYCOM proegram goes ta endwaf-job.- the buffer size for the next 
execution of the SYCOM program reverts back to the _ vatlue 
specified by the BUFFER parameter in the SYCOM parameters file. 


This parameter can only be interrogated by a workstation» A 
remote OCT or the system ODT can change the value of this 
parametere | | 


syntax: 
eBUFFER 
ee = Se 4 im <intecer> ==! im- Z <coaments> “71 
Semantics: 
integer Specifies the nugber cf bytes for the buffer used 
in file transfers. The value must be between 262 


) 


and 1950» inclusive. 


»EUFFER = 400 
»BUFFER 1950 
eEUFFER Queries the currert transmission buffer size. 
The receiving buffer size can also be 

interrogated by ertering the LIST PARAMETERS 


command to the SYCOM program. 


we ot & 
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BYE 

The YE command causes the SYCO™ croaram to Logtoff the cur 
user from the SYCOM program. It 14s valid from all stat 
inclucing the system ODT and anplicétion programs. If the 


is connected to the servernssystem SMCS by way the CON 
commands» an automatic DISCONNECT is initiated. If the tern 
is not owned ty the SYCOM program» 4 DETACH wessage is” sent 
the tocat SNCS. Also» the pseudotsitagnal character is rese 
default pseudc signal character. 


syntax: 
eBYE ee en ny ee eee Se ae ee On ee ee ee Wwe we Be eee a: 2 a on an an ae Om em Om On om om on on on ee 
I-- 2% <comments> --1 
Example: 


eBYE 


COMPUTER SYSTEMS GROUP |  B1800/B1700 SYCOM 


SANTA BARBARA PLANT Pe Se 2219 0458 CAD_ 


CL (Clear Device) 

The CL command causes the SYCOM program to clear a peripheral 
device if the device beccmes iroperable while receiving a data 
fite. The buffers associated with the specified device are. 
cleared and the receiving process is terminated. 


This command can only be entered frcem a remcte ODT or the systen 
CDT. | 


Syntax: 


(ee2: CP HSI I-- % <commerts> oi 
Semantics: 
LP eters the line orinter. 
cP Clears the card punch. 
Examples: 


eCfL LP 
CL CP 


SE ag ee ROE ee ee eg ge ete aaa a aa ea 
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CONNECT 


The CONNECT command causes the SYCO¥ program to Logton a terminal 
user to the serverw~system SMCS. 


The SYCOM pregram ensures that a MCE-tyne program is running in 
the serverwsystem and that a virtual station slot is available 
before making the connectior. 


If aeuser 1s ltLogged~on to the SYCO™ programr then that user's 
userccde/passwerd is forwarded to the MCS in the other systen 
which automatically logs the user on tc that MCS. | 


If switched data communication Lines ere being used» an Automatic 
Calling Lnit CACU) is oOresent»s ero a telephone number is 
proviced» then the SYCOM program initiates the dialroute 


Syntax: 
sCONKECT Horse ere eee er= = paaaas ee neg areas aa ke aad aa a 
in 4242 <comments> --] 
Exasples 


eCONNECT 


f 


5-16 
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COPY 

The COPY command causes’ the SYCCM prograt to initiate a file 
transfer. The command syntax provices for the transfer of files 
from =the initiating system to ancther system and from another 
system to the initiating system. Tre files can be in either 
magnetic tape or disk forme If the destination file already 


exists at the receivirg system» it will be removed and replaced 
by the transferred file. 


Syntax: | 


eCOPY <filenéeme-1> ere gee eee ee ears ee ee ae a ee ee ee eg ee er ee oe eee oe oe ee 


J 


j | 

d [¢qwwcecen , 2 oe on @ on on oe oF 88 On OF ee en om oe om we oe 1 j 
I i 1 1 
= 0 SsSeeS= / i sm~ <usercode part> =-" ) --1 


P=-/ 1 ferreteren--- LIST <1 
7 ye NO mT 


fromm REMOVE =----] 
frmnmon-- SAVE 9 wae} 
frccn-- SKIP <n> --=-1 
frocen= FILE =<" 2-! 


eoalts 
a 
| 
~ 
pu peed pa fend 


Sw we ween e ae Be ewe Bee SO Be ses Se Pee eee ee —~— 7/2 = as G2 «2 oe —_— 2 2 a we oe oe a on a ae oe oe Ot on 2 a ee ee a ee ee oe ee oe mo > 
i 1 1 iol 
I- BINARY ~! I= AS ww= <filenage-2> -1 I- C<usercode part>) ~I 
I i 


jr we - cee * —_ ae ae on |} 
> nae ae oe ee ee on ee ee ee ee ene ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee we B 
! 


I-~-- <volume-1> ---1 [---- 8 


© pet En oh Oey etn tell an gh <p ache Cediteolnds ili ete aaty 
—aliacthiislleadadlaiatllahldee STA bsick adi Ee 


See abe dec RIA aa gee eed titan i i, a a ee cee oct a veda alll Pith id oa air nddlealaadinalt ibctana ease haiti Sie eG aD aI a a st sis ie 
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a ee eee ee PI ee ae ee ee ee en oe eee 1 
I 1 
A 22 C Sees 1 fesse s > KIND C=] eecc- DLSK. “fesse eresS-= ). aes e B 
1 | I-- PACK => + I 
I { I-~ TAPE == 1 1 
1 | im TAPE? -~1 | 
{ 1 P= TAPED =". £1 
1 | j“— PETAPE =" 3.41 
.| | i | 
| == DISK S=Se3=-Sss"Ssees=—sS>5 | 
i 3 I 
f--7 1. <=" HOST L=1. <systen~“1d°i> “ece<<-+=- | 
0e9 422s $e 9 S525 = Sess ease Sas SS RSS SSS 3 S48 SSS 4 9S ees S S234 5 554== D 
j 
fae = LC. -SS=ss+2<s=2 SSS sSe3 SSS SSS Sse = Se SSS SSS S$ = SS SSS ese SS = C 
I--~ <volumer2> ~~~! f=ss="-) 
loss se5 +44 3554s=s=<4== o. RSS ses 22 55S see = SSS ] 
1 
CC e= °. SSses> i 2: fees s5> KIND C=] crc DISK Sess S-> ) <= So=> D 
1 J i-- PACK ==] a | 
I ] j=~ TAPE =——| 3.4 
i 1 == TAPE? == i | 
1 ] I-= TAPES w=! 1 1 
1 j P=" -PETAPE ==1 1] 
| 1 1 | 
| [ee= Disk Hs4S9sSsessssses<+s=+= 1 | 
I 1 
fes7 1 fe" HUST L=] <systetrid=2> “<<-"--- 1 
O Sess S= See SSeS sere SS SSS SHS Ss eS Se SSS eS SSS SSeS SS I 
im-- Z <comments> ~~] 
The <usercode part> syntax is shown in the following syntax 
diagréme | 
USEERT [=] @=="S— <usercode> =" ess sSS see S$ss5Se 36S 3 S454 4S5 5 ser === | 
{ }o-- » PASSWORD [=] <password> ~---|! 
1 1 
jer <usercode>/<p4assv0rd> SF Sesser see S4Se eS Sete a | 


Semantics: 


AS 


eh ee Se eT OE ae ee a 9 
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nes the servyer=systen to. create a new file eithe the name. 
specified. as filenare- Poe If the file is present on the 
server~systems» the command is abtortede | _ 


BINARY 

Applies to data files and causes the SYCOM orogram to expand 
all the records ina file prior to transmission. Code files 
ere always expanded. The BINARY option altows users to 
transfer files to and from an ASCII systen. If the BINARY 
cption is not specified for a data file transfer to a 
ronmEBCDIC systems the SYCOQM program changes non~graphic 
characters to question mark (€?) characters. The graphic 
character set 1s the EBCDIC recresentation of the 95 valid 
ASCII characters and the null character. | 
If a data file is sent to a CMS system CASCII machine) with 
the BINARY opticn specified» tc retrieve the same file and 
maintain file integrity» the CCPY or FETCH command must 
include the BINARY option. 


FILE 
Allows SYCOM to read the rames of the fite€s) to be 
transmitted from the filer <filename-1>. By using the FILE 
cpoticn»s a series cf files can transmitted by one COPY 
statement. Each filename must be entered on separate 
records in the file. If the cestination filename is to be 
cifferent than the source filenéwe» it itis entered fotlowing 
the source filename separatec by at teast one blank. 
Comments can fallow the last filename cn the record starting 
with a percent sign ("2"). 


filenasae-i1 | | 

Specifies the name of the file to be transmitted. The 
filename can be a single as cor a family es files in the 
format: “<nultifiletid>*/= | | 


filenane-2 

Assigns the name to be given tc the file on the deste ieee 
systems. The filename can be @¢ single fitie or a family of 
files in the format: “*<multifile-id>"/= 


KIND | | 

KIND is a keywerd which is used to describe the peripheral 
device of a file. The KINO keyword is rot required if the 
file is on diske : : 


LIST 
to be printed after transmission by zipping a command to the 
SYSTEM/BACKUP program 1f the MCP autobackup option 1s set. 
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NO 


Cverrides the default LIST attribute and 1s onty vatid for 
Printer backup files. 


REMOVE 

Causes the file to be reaoved from the sending system after 
the transfer has been completed. REMOVE is the default for 
fFrinter bcackup files. 


SAVE 
Ensures that a printer backup file is saved after the file 
1s transferred on the sendina systen. SAVE is the default 


for nonwprinter backup file transfer. 


SKIP <n> : 
Specifies how many files to skip if the “COPY 
<multifitertid>/=" or the indirect CFILE) option its used. 
The first “<n>" files of the farily are skipped. Usage of 
the keyword is optional. 


syster-id-1 
Specifies the system identification of the system from which 
the file is to be transferred frome 


systea wid-2 
Specifies the system identification of the system that is to 
receive the file. 


usercode and password | 
Identifies the user for the purpose of verifying access 
rights to the specified filename. 


volume-1 

Specifies the packwid or tape~ic for the source file. This 
cption 1s not required for files on the system disk» or if a 
packwid appears tn <filename 11>. "DISK" is used to indtcate 
the system disk. 


voluse-2 

Specifies the packwrid or tape~ic for the destination file. 
This option is not required for files on the system disk» or 
if a packwid appears in <filenasze-2>. 


€ 3) 

Parentheses are key characters when using a US» NO LIST» 
FEMOVE» or SAVE optione The options can appear in any order 
within the parentheses. 


z 
Assigns the filename specified in filename~i to filename-2. 
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Examples? 


—e COPY XYZ CUS=US/PASS) FROM CDISKk»e EQST=USER1) TO CDISKe HOST=SERVERYTS” 


eCOPY OMPALL AS DUMPALL FROM CHOST=FUB» KIND=TAPE) 
eCOPY SOL/= AS SDLNEW/= FROM CHOST=KUB) 

eCOPY RELEASE CFILE» NO LIST) TO CkOST=HUB) 

eCOPY = CUS A/B» SKIP 123) TO CHOST=USER3) 

eCOPY RELEASE CFILE» SKIP 9) T0 CHOST=USER5S) 


Exatples one and two are examples of single file transfer. 
Example three is an examole of a transfer cf a family of files 
and example fcur is an example of usirg a list of files to effect 
a transfer. Example five 1s an exaaple of using the SKIP option 
when transmitting a family cf files. Example six is an example 
of using 2 list of files with the SKIP optton. 
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CP NR CCard Punch Not Ready) 


The CP NR command causes the SYCOM program to inform the 
usermsystem that the system card punch is in aNot Ready state. 
The SYCOM program in turn inforas the serverwmsystem of the 
condition of the hardware. The serverwsysten suspends 
transfitting ény card purch deta stream messages currently in 
processe 


It is the responsibility of the userwsystem operator to inform 
SYCOM when the card punch is Reacy tc receive output. 


This command can only be entered from a remote ODT or the system 
ODT. 


syntaxs 


eCP NR ceeeeeee--- sola haetaiatatatatetaietetatatetatete en nena sence neense--- eaccen-- 


I-- 2% <comments> -~1 
Examples 


eCP RR 


PRD Ey 2 -o A Re 
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DEBUG 


The DEBUG command causes the SYCO™ frogram to print all data 
messages read or written by the SYCCM progran. If no option is 
specified» a request for the current status of the DEBUG facility 
is displayed. 


# | 
This parameter can only be interregated by a workstation. A 
remote ODT or the system GDI can charge .the setting of this 
parameter. 


syntax: 


eDEBUG a nnn ne nner n nn nnn nnn nnn nn 2 + ------------ atalasiietatabatetateieatatetatetatatatal | 


j-~- OFF -<-] I-~ Z <ccocagerts> =<] 
I-— ON cel 
{-- CUMP -<-1 


Semantics: 


OFF Terminates the debugging option. 
ON starts the debugging cption. 
DUMP Causes a dusp and List trace of the SYCOM program 


to ke initiated. Alsc» a siwiliar request is sent 
to the remote SYCOM gregraa. 


Examples 


-DEBLG 
eDEBUG ON 
eDEBLG OFF 
«DEBUG DUMP 
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DISCONNECT 


The DBISCQNNECT command causes the SYCOM program to terminate a 
session with a host serverwsystenm. The terminal is tLogged-off 
the serverc-system when a DISCONNECT tessage is sent to the other 
systest. The terminal reverts back tc its previous state cof betng 
signed onto the SYCOQM programe The terminal user is then free 
to enter more commands to the SYCOM crogranm.e 


ri a weeloges init HER ER aha phantaltea eZ boi eas RS smart to ety se re eae 
ie is Sis a SATA MLA ie RUF AD rida ld ha 1 au ee yee akbabren eS 


Syntax: 
eDISCONNECT ceeerrees*--=- osecroe= sec eene wean seeewe Sai ls sine in ali ae lo -—| 
I-- Z <comments> =! 
Example: 
eDISCOCNNECT 


The pseudowsignal character must be included tn the OISCONNECT 
commard> otherwise» if the tersinal ts cennected to the the 
remote systems» the DISCONNECT commarc is sent diractly to the 
remote system SMCS and the followirg message is displayed or it 
can te sert to the aprlication prograéasr that the user was signed 
On tde 


>> ERROR>S WCP REJECTED ZIP CONTRCL STRING 
INVALID MNEMONTIC$O1S 


The current pseudomsignat character 1S not changed by the 
DISCONNECT command. Cnty the BYE or SIGNAL SYCOM commands or the 
*OFF SCS command causes the pseudomsignat character to be reset 
to the default pseudo"signal character. 


semen it bi amea nT RATA EE nl ee ET ey ee ye 
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EQS | “ . 

The ECJ command causes an orderly shutcown of the SYCOM progran. 
No commands are processed. after the EQJ command is entered. The 
message PLEASE SIGN OFF ts broadcast te all terminals currently 
Logged~on. to the SYCOM prograa. A clase message 1s sent to the 
other system's SYCOM program after the completion of any 


inmprocess file transfers and when. there are no Longer any 
terminals connected to the remote systeme The SYCOM program then 
-sends a disconnect message to the retwork controller and goes to 
i a oy ee GME ae % 


This command can only be entered fren a ‘remote ODT or the system 
DOT. | | ne ae 


° 
ie 
Mae ° oe #, 
' » zs : ce sae, wt - r . “oY 
Syntaxs 6 ci eet bse 
Faas ae 2 a - 4 
; “fo. a re . fi % “hy s. 
, oe ‘ < ee eens ce * ~ wee gh 
- : ae . ae” ey ee eae : - = tet _— 
i . oe? bas R a ar , wey r bMRe ig } 7 =f a re . of ue 
‘« : — ON Rei” ee ee a kee o> Sacsisn 8 a Bet ee, * tee Fb 
of Aas heb, ne ¢ oe me St = aw meh ae * ° 
os ~ nee: Loe 
ye ty ai : ¢ wes e F 


I-- Tita peeren Sate <comments> eae | 
i-- xT a! ee ee Pane 


“eke 
ae om cy eins 
¥ He, aoe 7 SR 

: a ea 


Seman ti cs . 7 7 7 % = 7 oa 
oo * ;  ausés the. sYcoM progrem to initiate a dump. 
| _ 
| . 
DT | | Causes -the SYCOM procrem to initiate a dump 4nd a 
List trace. - 
xT | eee Cxuees the SYCOM program to initiate a list trace. 
“" . The Fe at character represents any non~blank 
character except the "OD" character. | 
Examcless 
eEQJ 
»ECJ OD % Causes a dump. . 
eEOJ ODT % Causes a dump anc List trace. , | 
~EQJ xT % Causes a tlist trace.» The “x™ character represents 
% 


any non~blank character excerpt the "“D" character. 


- & 
oa 
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FETCH 


The FETCH command causes the SYCOM program to Initiate ae file 
transfer from the serverw~system to the usermsystem. This command 
is a shorthand version of the COPY command. The files can be on 
Magnetic tape or diske 


syntax: 
sPEICh SPilendse i>. Ke Sees Sse ees SSeS Sea pee ea at eee es ree are > 
| 1 i 
1 <4 24> s. 2222222 eS25> +S s=e== j | 
! J 1 i 
te) 3 eee = f 1/7" <usercode part> "=" ) *] 
| 1 
ee) 1. fesse ess Se=s> LST == 4 
| bo- NO. ==] | 
| } 
(=<). 1 Je===s= REMOVE. <-<---= | 
f-e7: | Jee 7ss2 SAYE -=—==s>= ! 
ee): 1.7 ees se SKIP <n> w---7] 
p=) 1. Jess" PiILe. ==-=<=+= 1 
> -_ = or =f ae on ot on oe on Ge oe aoe 22 a a 2 a a wee oO ee oe ee eee es ee ee ee ee ee ee ee we ee ee ee oe oe ee oe oe 88 28 2 ee ee ee ee ee oe ee Oe ee ee ee oe ee 
| i J 1] 
Im BINARY 1 f= AS: eee== <filenamew2> 71 I- C<usercode part>) 
I 1 1 j 
t= -CNTO. =| f= <+==- === i 
> —_ = = OF an om a8 OD am OD Oe a GD Oe OE Oe ES Sw ew Oe we ee! ee |e! ee eS we ee ee ee ee oe 6 ee ee ee oe 8 ee oe ee ee 8 8 ee ee Oe ee ee es 
i | 
b=" FROM S92 $s Ss e355 6se ses e==s= 20> CKIND f=] w-~--- DISK aes De SS] 
| 1 l-~- PACK aes | | 
{== <yolunerl> “===> | I-- TAPE = | 
| l-- TAPE7 <==! { 
1 im TAPEQ ==! | 
1 i-- PETAPE -<-I I 
! j 
Lees e3s5SSees 25 = 2 ae aie a i 


Im~ (DISK) <7] 


pgs steht eat veke Ce Coy a ee pe ERY aliens, ed 5 i 
Beneath nd oniacpsatiicate ate A ae HO ed et hae ieee Bak Be be Leela el eet 
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> eee new eae nan nee anna _ << an ae 2 ee OS ae ae om sin ii “hy se: Gi“ “ais is Cc a See a eo nS = an = on om on ae 
Pm2 TQ coerce ene cncnseececnsee= (KIND [=] s2-- DISK 9 =-2- 


i , | l-- PACK --|] 
I-- <volume=2> =----1 | - im- TAPE --| 
| i | — I-- TAPE7 --1 

I | Im- TAPES =~] 

1 |  Jo= PETAPE --! 


> waewewewrwewewanaewent ea eee eee = on a ae MmMmWe S&S 4 ae ae see wees ewes ee wee eee ee eee wee | 


j-~- % <commenrnts> ~~! 


The <usercode part> syntax as skown tn the fotlowing syntax 
diagreéem. | | 


USTER] C=] c-"-" <usercode> ==-7- Sse sr Ss ss eaSe<SS3S= SSeaseSqoes<s > i 
i _ In-~ » PASSWORD f=] <password> -==1 
H i 
jae <usercode>/<p ass Kerd> SoSsS sees ene see as essers= | 


Semantics: 


AS 
Informs the serverwsystem to create a new file with the name 
specified as filename-2. If the file is present on the 


server~systems the command is atorted. 


BINARY 

footlies to data files and causes the SYCOM program to expand 
atl the records ina file prior te transmission. Code files 
ere atways expanded. The BINARY option allows users to 
transfer files to and from an ASCII transfer to a non~EBCDIC 
systems» the SYCOM program chances nonmgraphic characters to 
cuestion aark (2) characters. The graphic character set is 
the EBCDIC representation of the 95 valid ASCII characters 
end the rull character. 

If a data file is sent to a CMS system CASCII machine) with 
the BINARY option specified» to retrieve the same file and 
maintain file integrity» the ADD command must include the 
BINARY option. | 


FILE 

Atlows SYCOM to read the nases of the file€sd to be 
transmitted from the file» <filenamer1>. By using the FILE 
cptions a series of files can transmitted by one FETCH 


Sobol di lend aS al Sipe tsiheeSTatus tam! a sumliashe KpdariSCans nabs cin LaSTaa St cg Ee tt clone Yee Sect he ag gate apa eatert La sil ans aly Sst abba ithe Si ai ND a TA a ce SS ae ae Doe a a 
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statement. Each fitename = wrust be entered on separate 
records in the file. If the destinatior filename 1s to be 


cifferent than the source filerécte» it 1s entered following 
the source filename separatec by at tleast one blank» 
Comments can follow the last filerame on the record starting 
with a percent sign ("2%"). 


filenarse-1 

Specifies the name of the file to be transmitted. The 
filename can be a single file or a family of files in the 
format: “<multifiletid>"/=. 


filename-2 

Assigns the name to be given tec the file on the destination 
Systeme The filename can be a single file or a family of 
files in the format: “<multifilertid>"/=. 


KIND 
KIND 1s a keyword which ts used to describe the peripheral 


cevice of a fitlee The KIND keyword is not required 1f the 
file is on disk. | 


LIST 

Informs the receiving syster thet the orinter backup file is 
to be printed after transaissicr by zipping a command to the 
SYSTEM/BACKUP program if the MCP autobackup option 1s sete 


NO 
Cverrides the default LIST attribute and is oniy valid for 
printer backup filese 


REMOVE 

Causes the file to be removed frcem the sending system after 
the transfer has been conpleted« REMOVE is the default for 
rrinter taéckup files. 


SAVE 
Ensures that a printer backup file is saved after the file 
is transferred or the sendine systeme SAVE ts the default 


for nonsprinter backup file trarsfer. 


SKIP <n> 

Specifies how many files to skip 1f the “FETCH 
<multifiletid>/=" or the indirect (CFILE) option is used. 
The first “<n>" files of the family are skipped. Usage of 
the keyword is crtional. 


systeavid-1 
Specifies the system identification of the system from which 
the file is to be transferred frof. 


BURROUGHS CORPCRATION 
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system-id-2 


Specifies. the system identification of the system that 


receive the file.. 


usercode and password 


Identifies the user for 


the purpose 


rights to the specified filename. 


voluse-1 


Specifies the packrid or tapewic for the source file. 
cption is not required for fites on the system disk» or 
facktid appears 


in <filename-1>. 


the system diske 


voluse-2 


Specifies the packwid or tapesicd for the 
This option ts not required for files on the systema disk» 


if a packrid appears in <filenasze-2>. 


Cc ) 


Parentheses are key characters when using a 
REMOVE» or SAVE opttone 


within the parenthesese 


2 


Assigns the filename soecified ir filename~1 to filenane-2. 


Examples: 


eFETCH 
eFETCH 
FETCH 
eFETCH 


eFETCH 


eFETCH 


DMP ALL 

DMPALL FROM USER TO USER2 
USER/COBOL/= TQ DISK 
COECL/= TO USER 

= CUS A/Bs SKIP 99 

RELEASE CFILE» NO LIST) 


"DISK" 


o f 


The options can appear 
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is to 
access 


verifying 


This 
if a 


is used to indicate 


file. 
or 


destination 


NO LIST» 
in any order 


US» 


eFETCH SYCCM AS HUB FROM PACKA TC PACKB Z% same as following example 
oFETCH PACKA/SYCOM/ AS PACKS/HLUBS 2 same as preceding example 
eFETCH SDL/= AS SDLNEW/= TO PACKC % transfer of a family of 
files 
eFETCH = CUS A/B» SKIP 9) %Z alt CAI/= except first 9 
files 7 
eFETCH PACKD/COBS0L74/= T0 DISK % "DISK" as volume id means 
system disk 
eFETCH COEOL74/= FROM PACKD 2 same as oreceding example 
The first exampte will use the save destination name as the 
source name. The second example uses different pack ids. The 
third example takes a family of files fron a user pack to _ the 


System disk. 


the syster 
ail the 


files uncer the usercodes 
The sixth examcle 


disk tc the pack USER. 


TAM» 


except the first nine. 
is an example of using a list of files. 


The fourth example transfers a family of files from 
The fifth example wilt 


fetch 
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GROUPSIZE 


The groupsize command displays or changes the groupsize used _ for 
dividing families cf files into grourse 


The groupsize is used to restrict the number of files that will 
be sert a one time when sencing ar ertire faswily of files (Ci-.e. 
PUT SYSTEM/=). 


This parameter can only be interrcgated by a workstation. A 
remote OCT or the system ODOT can change the vatue of this 
parameter. | 


syntax 
eaGROLPSIZE OS SO ee ee ee Go lia es las else al Gxt acer cae aed Ga cesar a ‘ai Sth tap as j 
i i 
ee te <integer> e--.-4" i 
Semantics: 
integer One or two digit integer value between one and 99 


that represerts tne new value cf the groupsize. 


Examcle: 


eGROUPSIZE 
eCRQUPSTZE 15 


. 2 = Ss aw ss Be, Sep ee ear A oe cx a ee ee SS gett ae ote oe WRIA Lae Se he See Fg he ch ante Bevel Ei we Le ky Mb wet ie oe Liat ioe Bis Sine > ete DE Ca te Magli! erty ROU ee nape daa eyagy ta dey phe ba iatninn ntehinettiasrite Ge acto M1 yim gst emt a edn ms hm ystee A s 
Sinn ce sna mone Sanh Ss hi ei Ba aa ei ca a eh ES a kt a ce Sd ety nD aoc hare ST nw Berna ng i. ube nbn san ix hi teased teas a bak sine anes Saas eae ef ee Det eevee eae Sus hak fine MES Saat, at a z 


ae re eS Na eR TR OC Tear RETE CTE OTOL ACS COO Teas ESTO SONOS NS TOS Oa a ge <> 
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LIST 

The LIST command displays infermatior about the system and tts 
usersae Coamand options provide Lists of these users currently 
Signed on» terminals that are currently online» and file 


transfers that are currently scheculed to occur. 


syntax: 


[<----- eo ee nnnn---- ------ I 
_ | 
eLIST <"3e2++=-- CLOTRACE SS ee ae ee ee ee ee ae Sh ay SS ce com Se Sn ye a 1 
I--~ PARAMETERS “-~] i-- Z <comments> ="! 
f--~- PUTCUEUE =Se4 
jem-> SCHEDULE amen] 
f--~ TERMINALS =~] 


fee= TRACE ==) 
be== USERS ==] 
Semantics: 
OLDTRACE Prints the last trace file created by SYCOM. 
PARAMETERS Displays the parameters SYCOM Is using. 
PUTQUEUE Prints the current rarce of file transfer requests 
that were initiated by a PUT request. The tist 


provides a list of up tec the Last 99 PUT requests. 


SCHEDULE Displays att file transfers currently in the 
schedule tn schedule rumber order. 

TERMINAL Displays ati terninals that are currently on line. 

TRACE Prints the current trace file being written by 

: SYCOM. 

USERS Displays alt of the users of the SYCOM program. 


Examples: 


»LIST CLDTRACE 

eLIST PARAMETERS | | é 
sLIST PUTGUEUE 

eLIST SCHEDULE 

eLIST TERMINALS 

eLIST TRACE 

-LIST USERS | 

sLIST OLDTRACE PARAMETERS PUTQUELE SCHEDULE TERMINALS TRACE USERS¢-~y 


i ubet ena bitmnsderp owes wricasn Sasdeesd-lieaor senate ana ax wml eb asp sens aces ication aba at aSatihsctese Cacao ate is asa cbs a seal Rai aie inane a tn aD basin in ei aaah ons thiw caSyleisa Sa iy 
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LOG 


The LCG command causes the SYCOM procram to display the number of 
occurrences of specific data communication line errors’ and 
certain wmessaece transmission statistics. The totals in the 
counters can be initialized if the CLEAR option is included in 
the commande 


Syntax: 


Semantics: 


CLEAR Resets the tog counters and closes the statistics 
file. 


Example: 


LOG 
2LO0G CLEAR 


: ats “Ss a Pr a oe oe lt ea Toa ak, | 


then suspends transmission of the line printer data strean 
messages until notified te resume by the user~system SYCOQM 
program. | | 
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LP 
The LP command informs the userssystem SYCOM program ~ that the 
Line printer is Not Readye The SYCOM prograa informs the 
serverwsystem of this temporary concition. The servermsystem 


It is the responsitility of the userwsystes operator to inform 


SYCOM when the Line printer 1s again Ready to receive output 
datde 


This command can only be entered from a remote ODT or the systen 


ODT. 


Syntax: 


Examples 


eLP NR 


SS ides a oa td ah bea fiat ea suits aeaaea cast isots i SoAUs etapa ee onset Ce Sia yn Ea 


seis P32 aly aw Fins tin Belay URERS Sih ine Sabla alin itt anes ce a da es seo leans sale ee iy slanted Sai acon ida lactlec ois aS he IS Sauce Sb ta lay Settee ut ae hil sal i ana tetas “eh chin Mia al at obanat Les kok Nea ier ince adainslSed k dyn 
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OFFLINE 


The CFFLINE command causes the SYCOM program to obr 


0456 CA) 


eak the 


existing connecticn with the other system» gc into standby moder 
and wéit for the other system to catl back. This command can be 
used for either a switched or ronwswitched Data Comm Line 
connectione when a “DLE ENQ™ 3s received from the other system» 


the retwork controtler re~establishes the connection 
other system end normal operations resume. 


This command can oniy be entered fron a remote ODT or the 


OOT. 
syntax: 
SORTING. So rsser> Sie ee ei See eee SS Sea Se Se 2S =e SS = 
I-- Z <comments> ~~] 
Example: 
e OFFLINE 


with the 


System 
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ONLINE 


The CNLINE ccommand causes the netxerk controller to attempt to 
re-establish the Line connection to the server=system. 


The error  wmessage RETRIES“UP is cisplayed when the current. 
message buffer being sent to the server~system is not being 
receivede By entering the ONLINE command» the message buffer 
being sent is discarded and an attempt is made to recestablish 
the Line connection. | 


This command can only be entered fres a remote ODOT or the system 
ODT. 


syntax: 
eGNLINE aa a cag i ara asa Ra asso Sa is ales a a ay crass — = “. = a on an ee ae eee keteeterieetenten teeter ten teeteoniete tented | 
j-- Z% <comments> =~! 
Example: 


»ONLINE 


Bea as Ml ls Ne rR cea cm cas gh ade et et seta ht a tat pi ie inant Secs ii oak a beri Sama cavy titans ih etch eta is ame or inant en eat ents e peeo ie  ae ha Sac ee eect sos melas 2 mises lait arc dat lia at ca ce ek at ae a Si tae ote tana cau so Ebiaba Lua, 
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PHONE 


The PHONE command causes the SYCOM program to provide to the 
network controller with a tetephone rumber for the Automatic Call 
Unit CACUD oar display the existing telerhone number to a 
predefined serverv~system. The autcmatic dtaltout using an 
Autometic Calling Unit CACU) to a snecific server~system requires 
that @€ phone number be present. 


This parameter can only be tnterrogated fror sg workstattione A 
remcte ODT or the systesw ODT. cér change the value of this 
parametere 
syntax: 

ePHCAE ee ee Pe eee SE eee eee, se ee ee ey SY 2. aw eewe wens en awenen wwe ee we we ee —_—- on a an oe j 


(<= =] I-" <telephone rumrber> --1] Im-- % <comments> --1 


Semantics: 


phone number The telephone runber cf the serverwsystem. The 
maximum number of numeric characters 1s 20. 
(- = Clears the existing telephone numder. 
a 


sont oe ppentecmcreee es cee ix oe 


Us 2 too Re 


5 ee tet keel SEE 


SE A Sa Sea ea os oe Rag Ste era ES tee eae ~ jy" 57 
BURROLGHS CORPORATION : — COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP _ «81800781700 sYcomM 
SANTA BARBARA PLANT | Pa Se 2219 0458 CAD 


Examples: 


| PHONE = 222 333- 4444 yA Assigns a new telephone nunber e 
ePHONE = a 4 Ciears any prior telephone number. 
e PHONE & Queries the current telephone number. 


(fo oN 
we 
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PROGRAM 


The FROGRAM command is used to interrogate» enable» or disable 
program input to SYCQM. 


This farameter can only be interrogatec by a workstatione A 
remote ODOT or the system ODT car change the setting of this 
parameter. 


syntax: 


ePRCCRAM See eee ge ge ee ee ee cam um ewe su meena aa = oa oe oe es os we <on2=]} 


Semantics: 

ON Turns the program tnput férameter cn. 
OFF Turns the program infut fpéranmeter off. 
Examrles: 

o@PRCGRAM 


ePRCCRAM ON 
ePROGRAM OFF 
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PUT 


The PLT commanc causes the SYCOM progran to initiate a_ file 
transfer from the user=system to the server~systeme This command 
is a shorthand version of the COPY ccrmand. The files can be on 
magnetic tape or disk. : 


syntax: 
ePUl <47 lenare i> sere ees3s2+sS<s>== ee ee ene aoe ae aa aoe te = a oe a > 
i | i | 
| i<=s3sse= g SSeS Ss245 Ss Ses —=>= { | 
j { | i 
(<= { “sees = 41 fem <usercode part> 7-" ) ==! 
j j 
es. 4. fees S4SeS== >= List =4 
j P=] NG ==] ] 
j | 
fens 1 fees s== REMOVE =eee= { 
fe=7 7 J2-3-== SAVE = ==e= I 
fe=/- 1 Js ss> SKIP <n> -=-~1 
foes 1 fowewers FILE sore] 
Sci Oa sda he ao a asco a ota sae oe iiascaans samaebew awe ewes sreEeeweeen ae. 
1 i] | 1 
i= BINARY “1. 4° AS sere <filename-2> -1 I- (<usercode part>) 7] 
] i] | ? . 
i> CNG 1 12S Sss" 2-369 <=5'] 
>--s2=— owe e ee sew ee ee eee seme en ose eee oc ewe ee eee eee eee eee wee = => 
i | 
[2 * FRCM eS See eee eee eee reser esse CKEND ta) See 2TSk Seo: =] 
1 i Im~ PACK mee] j 
Ie" <volumes1> <-"---!1 Im- TAPE alee | 1 
i Im~ TAPES =~! | 
J | se TAPES <=] i 
] f=" PETAPE ==] i 
I | 
[--<---= wasee ween owen eee es mee meee eas | 


I-- (DISK) --1 


Sk, Sate ab Ni ee ok Neng oe tae aot eee estar ae Ul aes pe Sees Rgds Sa Nee wea ia ak Sa an A Meta aN aa in ioe gh ee ee ke ea Va Late eS Gia: Sele ia eae or aa Gens aaa 20 poh aag sel ual abled la Sie Sante nce 86a Hh dt tse hcl nts sda Sea ius en uaa cans aad 253th beige tc anabolic Be Ey, «eb itt ttn de 5b Leer asters es tae cee toe oath a aed at al ede ad glk Stl wT A ately aM 
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Ym awoe ewe & w= a ee See eegae © wee ae a eS an ee ee 8 ee me a Gt 2 @ an os ae ee mm @ an en es ow a es ep & ae m= =P os os 6 a esuaesnweae ea wee» 
I } 
Le. “0. sess S5-SS sss >== senesee= CKIND.€=] =-=— DISK =o 2D | 
i i I-~ PACK o] 1 
I-- <volumer2> err] fo= TAPE == | 
| == TAPE oS] { 
j j-- TAPES <--I ! 
I Im- PETAPE --1 | 
1 | 
j-- een 6 a ee a 2 oe ae SS a ee OP 8 oP S28 ee Ce om oP oO ee 28 Oe ee Oe a ee ee ee 2 oe a oe ] 
fe" (DISK) <1 
: Peewee es eee en cee es ee see ee errors === eee wee ene ee eee eee ew en ee w eee eee ere 1 
| I-- Z% <comments> --1 
| The <usercode part> syntax 1S shown in the following syntax 
| diagrém. 
USTERD (=) ===> SUSE COC E>. Sos seSeeS S23 Se 2 2S eS Sse 2=-<= SSS - ss =>> { 
| i-“-~- » PASSWORD [=] <password> --~] 
1 j 
jer] <usercode>/<passhord> = "-<93Se¢>s> ====- SSeS SS] 


Semantics: 


AS | 
Informs the serverwsystem to create a new file with the name 
specified as ftitlenamer2. It the file is present on the 


server~“systems» the command 1s aborted. 


BINARY 

Applies to data files and causes the SYCOM program to expand 
ell the records ina file pricr tc transsission. Code files 
ére always expanded. The BINARY option atlows users to 
transfer files to and from an ASCII system. If the BINARY 
cption 1s not specified for a cata file transfer to a 
nonm~EBCDIC systems the SYCOPF program changes nongraphic 
Ccharéecters to question mark (€?) characters. The graphic 
character set is the EB8CDIC representation of the 95 vatid 
ASCII characters and the null character. 

If a data file is sert to a CMS system CASCII machined with 
the BINARY opticn specifiedr toa retrieve the same file and 
Raintain file integritys the ACD command must include the 
EINARY option. 


FILE | 

AltLows SYCOM to read the names of the file€s) to be 
transmitted from the file» <filerame-1>. By using the FILE 
cotions a series of files can transmitted by one PUT 


statement. Each filename must be entered on separate 
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records in the file. If the cestination filename is to be 


cifferent than the source filename» it is entered following — 


the source filename separatec by at teast one blank. 


 Comaents can follow the Last tilename on the record starting 


with a percent Sign ("2"). 


Aitenaes=i 


Specifies the rame of the file to be transmitted. The 


filename can be a single file cr a family of files in the 


format: “<multifilertid>"/= 


filenaae-2 
Assigns the name to be given to the file on the destination 
systeme The filename can be a single file or a famity of 


fites in the format? “<multifile-id>"*/= 


KIND | 
KIND is a keyword which is used to describe the peripheral 


cevice of a file. The KIND keyword is not required if the 
file is cn disk. | 


LIST 

Informs the receiving egecan that the printer backup file is 
to be printed after transmissior Cy zipping a command to the 
SYSTEM/BACKUP program if the MCP autobackup option is set. 


‘NO 


Cverrides the default LIST attribute and is only valid for 
crinter béckup filese 


REMOVE | 

Causes the file to be removed from the sending system after 
the transfer has been completed. REMOVE is the default for 
printer backup filese 


™ 


SAVE | 
Ensures that a printer backup file is saved after the file 
is transferred on the sending system. SAVE is the default 


for non-printer tackup file trarsfer. 


SKIP <n> 
Specifies how many files to skip if the "PUT 
<multifilertid>/= or the indirect CFILE) option is used. 


The first "<n>* files of the ba euty are skipped. Usage of 
the keyword ts a 

systermtid-1 

Specifies the system identification of the system from which 
the file is to be transferred frcme 


Ge NS, 
e a 
i 
f 

eed 
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system~id-2 
Specifies the system identification of the system that 1s to 
receive the file. 


usercode and password 
Identifies the user for the fpurpose of verifying access 
rights to the specified filename. 


voluse-l 

Specifies the packwtid or tapetid for the source file. This 
cption is not required for files on the system disk» or if a 
cecktid apocears in <filenamerl>. “OISK™ is used to indicate 
the system disk. 


voluse-2 

Specifies the packwid or tapertid for the destination file. 
Thais option is not required for files on the system disk» or 
if a packrid appears in <filenasze-2>. 


C ) 

Parentheses are key characters when using a US» NO LIST» 
FEMOVE» or SAVE optione The options can anpear in any order 
within the parenthesese 


2 
Assigns the filename specified ir filename-1 to filename~2. 


Examples: 


»PUT DMPALL 

ePUT DMPALL FROM USER1I TO USER2 

ePUT USER/COBOL/= TO DISK 

»FUT COBOL/= TO USER 

eFUT = CUS ASB» SKIP 9) 

~PUT RELEASE CFILE» NO LIST) 

ePUT RELFILES CFILE» NO LIST» SAVE) 
% file RELFILES contains List cf files ta be sents» with 
2 destination names if differert from source namese NO 
% LIST wilt prevent automatic AP at destination end if 
% these files are reauired te te on disk for a subsequent 

SYSTE¥/COPY to release tape. 


The first exampte wilt use the same destination name as the 
source name. The second example uses different pack idse The 
third example takes a famity of tiles from a user pack to the 
syster diske The fourth exaupte trarsfers a family of files from 
the system disk to the pack USER. The fifth exampte witt put ail 
the files under the usercode» “™A"» except the first nine. The 
Sixth example is an example of using a list of files. 
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QS CQueue Size) 


The G3 command causes the SYCOM procram to change or interrogate 
the CLELESIZE pérameter. If the QS ccmmand is not followed by a 
equal sign or numbers» the current value is displayed. If the 95 
command is followed by a number between 4 and 15% inclusive» the 
SYCOM program changes the QUEUVESIZE pérameter accordingly. 


If the QUEUESIZE parameter has been changed by entering the QS 
commard and the SYCOM program goes tc endof-job» the value of 
QUEUESIZE paréemeter praverts back to the value specified in the 
parameters file. | | 


The equal sign (=) character is cpticrat for the QS command. 
This parameter can only be interrogated by a workstation. 


remote OCT cr the syste#t ODT cén change the vatue of this 
parameter. 7 


syntax: 
2935 2 2 2 a ae a ee ee lalate tahatatetatatatatatatatatabetatatetetaetatatatatetatetatatanaataatetatataatetaateaatatal 
I-~ = 771] I" <integer> --! I-- % <ccmments> 7 Px 
| | | | Gy 
Semantics: a 
= Optional key character which can be used when 
changing the value of CLEUVESIZE. 
integer One oar two digit irteger value between 4 and 15 


which assigns the rew cueue depth Limit. 
Examples: 


e€$=3 

ofS 12 

ofS @ Cisplays current value cf the cueuesize and 
*% associated marker offset. 
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READ 


The READ command causes the SYCOM prceccram to open aie card=image 
file and begin transmitting the data to the host system. when 
end-cof-file is detected» the carcwigsge file is closede- One READ 
command 1s required to read each carc™image file. 


The READ command is only vatid if the SYCOM program is propertly 
lLoggedon to the host systeme. It ts possible to override this 
feature by entering the RY CR Cready card reader) command to the 
SYCOM programe 


All nenwgraphic characters are replacec with the question mark 
€?) character. | 


This coamand can only be entered frem a remote ODT or the system 
OCT. 


syntax: 


eREAL — << =n ae on oS = a oe an 0 Ge as Oe oe aE ow we ae on ee Se ee eee ee Ee ee Se ee ee eee eT ~— oa on ee on 2 on oe oe { 
Imm <filename> -~"1 {"" <device type> ~"1 I-- Z% <comments> =~! 


ees Semantics: 


Filenéeme Specifies the label cf the file. The SYCOM 
| program uses the filerame specified to Locate the 

file on the designatec cevice type. The filename 

must have ro embedded blanks. The default file 


name 315 RJE/CARDS. 


device tyre Specifies the type cf device the SYCOM program ts 
to read from. Allowable entries are DISK or blank 
Ccard reader device). the default device is CARD. 
If the packrid is inctuded in the filenames DISK 
1s assumed as the device type. 
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Examptes: 


eREAD SOURCE 2% Care cevice is assumed. 


READ USERPACK/SOURCE/FILE % Disk device is assumed since 

| ; % there are two slash (/) characters. 
»READ DISK/FILE DISK Z Disk cevice is required since 
% there is one slash (€/) character. 


e READ The filename defaults to RJECARDS 


end cevice type defaults to 


eee 


) CARD .READER« 
4 
: 
| 


REE a ohne IRS I 


Seer 
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RESTART 


The RESTART coamand causes the SYCOM program to reinitialize» 
break the data communication conrection to the other systems 
flush the PUTQCUEUE» and go into a standby state and wait for a 
connection tc be tritiated» by entry of either the ONLINE or 
CONNECT commard to the SYCOM progragr.e 


If a schedule number 1s supplied» the SYCOM program 
remestablishes the connection with the other system and restarts 
the file transfers beginning with the supplied schedule nua@ber. 
Only the tast 99 PUT commands in the PUTQUEUE can be restarted. 
Therefore» that the schedule numbers available for restarting are 
between the current PUT schedule nuster Less 99» and the current 
PUT schedule number. If a minus sicn (7) character appears in 
front of the schecule number» then the SYCOM program begins 
transferring atl of the files in the PUTQUEVE starting with the 
current PUT schedule number less the number specified in the 
RESTART commance 


If a clus sign €+) character appears in front of the schedule 
number» then the SYCOM program tegins transferring atl of the 
files in the PUTQUEUE starting with the current PUT schedule 
number plus the number specified in the RESTART command. 


This command can onty be entered frcm a remcte ODT or the system 
ODT. 


syntax: 


eRESTART ----- eaiesleierieriateereeiatebatenatetatastartatatetaetanebebanaiatetatatananababetabetaatetatenatarematater ----> 


j--=- — on an = on oe = a ae a oe oe oe — oe we ee ww ow ee ee oe Oe oe <integer> mae | 


[ i-- <minus sign (7*) character> ~~] 
i Im-- <plus sign (+) character> --~! 
] 


lo- RESET cree nnn nnn nace ncrnnaee----- sstahatatateatetataanenatate 


semantics: 
minus sign The mtirus sign (7) character. 


plus sign The olus sign (#) character. 


i ae mec ste healers Sie a oo IS = arn 


~ Saher 


 BURROLGHS CORPCRATION : COMPANY CONFIDENTIAL 

COMPUTER SYSTEMS GROUP | | -—-- B18007B1700 SYCOM 
SANTA BARBARA PLANT | | Pe. Se 2219 0458 CA) 
integer - Specifies the number (located in the PUTQUEUE and 


can be interrogated ty entering the LIST SCHEDULE 
~SYCOM command) to stert the file transfers from. 


RESET Causes the SYCOM program to discannect and Loogwof f 
| all users. 


Examples: 


eRESTART 


| Flushes the PUTQUEUE and goes into Idle state. 
eRFESTART 12 


Fd 

2 Remestablish cannection and restart file transfer 

2 teginning with the schedule number 12 in the 

2 PUTQUEUE. 

eRESTART =-5 Z Remestablish connection and restart file transfers 
% beginning with the last five file transfers in the 
Z PUTQUEUE. 

& Remestablish connection and restart file transfers 

4 beginning skippirg three file transfers in the 

Z PUTQUEUE. 

% Disconnects and Icgqsvroff atl users. 


eFESTART +43 


eRESTART RESET 
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RY CReady Device) 

The FY command informs the SYCO¥ program that the specified 
peripheral device is currently ready tc serd or receive data. 
The ‘SYCQOM program also notifies the server~system that the 
peripheral device is ready to send or receive data. 


This command can only be entered frca aremote ODT or the’ system 
ODT. 


Syntax: 


Semantics: 


CR Ready the card reacere 
CP Ready the card punche 
LP Ready the Line printere 


Examples: 


RY CR 


o=RkY CP Z Must be entered if punch cutput is from the 
%Z E 10900 RJE/CONTROLLER poregram. 


efY LP 
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SIGNAL 

The ‘SIGNAL command causes the SYCOM program to display or change 
the current SYCOM pseudowsignal character. This facilitates 
communication with more than one SYCOM program. If a new 
pseudc“signat character is not specified in the SIGNAL command» 
the current pseudosignal character is displayed. If SMCS is 


executing and the SYCOM user is signed on to the SYCOM programs 
changing the SYCOM pseudowsignati character orly applies to the 
one users leaving the SYCOM pseude-signal characters for the 
other users unchanged. 


The default character for the SYCCM pseudossignal character is 
the period (-) character or whatever character that is defined as 
the pseudosignal character in the carameters file at 
beginnring-of~job. The pseudomsiqnal character reverts back to 
the default pseudo~signal character efter a station is signed off 
the SYCOM program or when the SYCCM crogram goes to endtof~job. 
A stétion cer te signed off the program by entering the BYE 
commard to the SYCOM program or the *CFF command to the SMCS. 
The pseudomsicnal character is not required when a terminal is 
not ccnnected to a servermsysteme | 


The SYCOM pseudomsignal character is required when entering SYCOM 
progréem ccmmands to the SYCOM proarée# on the system ODT and the 
systenm CDT is not connected to the rea#cte systensr otherwisesr the 
messace is sent to the remote systerw COT. 


syntax: 
I--~ <pseudo"signal character> -=-1 i-- % <comments> =! 
Semantics: 


pseucosignal character The new pseudomsignal character for the 
current SYCOM user. 


Examptiess 


»STGNAL 
eSIGNAL 2 


~~ - - a x FG ee ee a 
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SIZE 


The SIZE command causes the SYCOM orcgram to display or change 
the maximum message buffer size fer transmitting and receiving 
purposeSse The SYCOM program then informs the serverwsystem of 
this change with a special system control type message. This 
comward applies onty to the RJE functicn of SYCOM. 


This parameter can only be interrogatec by a workstation. A 

remote OCT or the system OQ9T cér change the value of this 

parameter. 

Syntax: 

eSILZE _ om m2 a ae a a aE Wm 2 48 2 oO GS ee 6 ae = 28 @ we Gs ae -™ sp <n a an ae a A Se SS i A ee ae ae ae a So a mo 
(ae ee] Jj-- <integer> ~~!  I-7 Z% <comments> ~~! 

Semantics: 

integer A 3-digit number which assiaqns the RJE buffer 
Size. The value aust be between 0786 to 400» 
inclusive. 


Examples: 


»~SIZE=400 Z Equal sign (C=) character 1s optional. 
efIZE 132 
SIZE Z Causes the SYCO™M procram to display 

% the current RJE buffer size. 
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STOP 

The STOP command causes the SYCOM prcgram to immediately shut the 
System downe No further input sessages are accepted and the 
SYCO¥ procram coes to endtof~job. Terminals are not lLogged-off» 


virtual terminals are not disconnected» nor is an intersystem 
connection disconnected. Also» printer listings of the 
DISK_ TRACE file and/or a SYCO™ prcgram dump are generated» iif 
requested. | , | 


This command can only be entered frea @ remcte ODT or the system 
GOT. | 


Syntax: 


eSTOP ------- ioeewereetwe we Snee ease ee sseeuneeasceseeeudeceses. 


I-- CLT] --1 == Z <commerts> =~! 


semantics: 
D Causes the SYCOM procram to initiate a dump. 


DT Causes the SYCOM procram to initiate a dump and a 
list trace. 


xT Causes the SYCOM proocram to initiate a list trace. 
The Se character represents any non~bdiank 
Character except the “O" character. 


Examples: 


» STOP 

eSTOP OD % Causes a dump. 

eSTCGP ODT Z Causes a dump and List trace. 

eSTOP IT % Causes a list tracee The "I" character represen 


4 any nonwblank character except the "D" character 


ts 


[Sih hl nacional eins ats eek 
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SV CSéeve Device) 

The SV command directs the user"system to Inform the 
serverwsystem to cease transmittirg the card punch or line 
printer data stream and to save the entire file at the 
serverwsysteme The SV commanc permanently inhibits the 
transmission cf any further card punch or tine oprinter data 
streants until notified by the userwsysten. 


This cosmand can only be entered frcr a remote ODT or the systen 
OOT. 


oyntaxs 


Semantics? 
CP Save the card punch. 
LP Save the line printer. 


Examples: 


eoV CP 
eSV LP 
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SYSTENID 


The SYSTEMID command cisplays or changes the current value of 
SYSTEMID. If a new SYSTEMID is entered» then it is sent to the 
remote system yia the appropriate SYCOM contrcl message. If the 
systetid has not be entered» the system hostname» entered by the 
MCP "FN" command will be used as the SYSTEMID. 


This parameter can only be interragateqc by a workstation. A 
remote ODT or the system ODT cér change the value of this 
parameter. 
syntax: 
e2t ole See esse SS ses =>5> Se ee re te cee ee ee ne ee ee 
1 i 
fener <ydentifier> <==9==1 


Semantics: 


<identifier> An identifier of up to seventeen characters 


containing onty alpharumeric characters used to 
identify the new systetide a 


Examples: 


eSYSTEMID 
eSYSTEMID AARDVARK 
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TRACE 


The TRACE command precvides the facilities for tracing alt SYCOM 

input/output messages which are saintained ina file tabeled 

DISK_TRACE}j The command is only valid if entered from the system 

ODT cr arenrcte GOT staticn. Wher TRACE 1s entered without an 
’ | attritute» the current status of the trace option is returned. 


The disk tracing facility is used itn conjunction with Program 
Switch 2. If Program Switch 2 1s ecualt to Q» no data is traced» 
and only intersystem SYCOM program ccrtrol wessages are traced. 
If Program Switch 2 185 equat to 15» ail data is traced. If 
Program Switch 2 1s equal to a number between 0 and 15» then on 
Lines of data are entered into the trace file» where nis the 
assigred value of Program Switch 2. 


The size of the DISK_TRACE file can be controlled by the 
parameters TRACEAREAS» TRACEBA» and IRACERB» which default to 20» 
10» and 4» respectively. 


This parameter can onty be interregatecd by a workstation. A 
remote CDT or the system ODT can change the value of this 
parameter. 


Syntaxs 


eTRACE She a ne ey OO eee Re eR Pee, ee, a Tee wee ewan eee eB wee Ss Be wee Bee ew ee emote we awa & | 


=s= (Ne eens I-7-- Z <comments> oo] 
pa-= (Fr ===] 


Semantics: 
ON Starts the tracing furctton. 
OFF Stops the tracing function. 


Examples: 


e TRACE % Causes the SYCOM program to display the 
% current status of the IRACE boclean. 

e TRACE ON 

eTRACE OFF 


Note that the disk tracing facility is used in conjunction with 
program switch 2. If program switch 2 1s equal to zeros» then 
only interssystem control messages are traced.e- If program switch 
2 is set to anontzero value» then a number of tines of data 
equal to the setting of program switch 2 1s traced in addition to 
the irterwsystem control messages. 
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USER 

The USER command assigns the specitied usercode/password as the 
default userccde/password for file transfers when none is 
specified ina COPY» PUT» or FETCH command. The 


usercede/password is rot validated when entered but is forwarded 
to the other system when a CONNECT ccmmand is processede | 


If no usercode/password is supplied» the station is disconnected 
Cif connected) and the usercode is rewoved from the SYCOM program 
users table. This allows the user the ability to be logged-off 
the SYCO™M program without signing off. The BYE SYCOM = prograan. 
commard signs off the SYCOM user éerc detaches the station from 
the SYCOM procran. 


The usercode and password can be up te 17 characters each  =@£for 
com@M@unication with non~-81i000 systems. 


syntax: 
eUSIER] woe e------ a no a eee wees eee enee ones ere wren eee === Tame e> 


Im“-~- /<password> ---! 


> ae a ee wa a on on a on a nw i wn ee ee ee ene en |] 


I-~ 2 <comments> =i 
Semantics: 


userccde A symbol which consists of from 1 to 17 characters 
to idertify the user. The 81000 computer system 
is Limited to an 8 character usercode. 


passwcrd A unique string c f characters used for 
identification purpeses to meet security 
requirementse 


Examples: 


eUSER ODT 
eUS CDOT/USER 
eUS If a user is togged on to the SYCOM programs 
then the user is togqged off. Also» if the 
Station is connectecs» then the station is 
automatically disccrnected-e- The station 
remains attached to the SYCO™ program. 


NTL NT 2 
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WAIT 


The WAIT command is used to interrcgate or change the status of 
the WAIT parawreter. 


This parameter can only be interrogated by a workstation. A 
remote ODT or the syste# ODT cen change the value of this 
parameter. 


Syntax: 


Jocern- ON seme) ises--- Z <comments> ---~--1 
Jmsern- OFF -----1 


Semantics: 
ON Turns the wait parateter one 
OFF Turns the wait paramter off. 
Examples: 

eWAIT 


eWAIT CN 
eWAIT OFF 
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WHAT 

The kEAT command causes the SYCOM precogram ta cisplay the current 
status of program processing activitye The reply message from 
the SYCOM program is variable in cortent and Length to reflect as 
many conditions as possible. If a fite is in the process of 


being transferred» its name and the number of records transferred 
are cisplayad. 


Syntax: 


eHHAT et ee ee ee ee ee ae eee ee ee semen wee ee ee oe ee eee nee wee fe wee eee em eee eae | 


J 1 Inm~- Z <comments> “I 
se) ===) 
1 1 
ies 6 ===] 
l 1 
jes = ===] 
semantics: 
U Appends the output of a “LIST USERS” command to 


the normal output cf the "WHAT™ command. 


S Appends the output of a "LIST SCHEDULE" command to 
the nermat output cf the "WHAT" command. 


= — Appends the output cf both a “LIST USERS” and a 


PLIST SCHEDULE™ conmard to the normal output of a 
"WHAT™ command. 


Examples: 


oWHHAT 
eWHAT 
eWHAT 
oWHAT 


Vac 
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SMCS Cosmand String from User~Systes 


This command syntax allows a tergwinael user on the userwmsystem to 
give commands to the serverwsystem S*YCS for processinge Commands 
which are entered from a terminat and prefixed with a signal 
charéecter of astertsk (C€*) are irtercepted by’ the network 
contrctler and are immediately sert to the SMCS for processing. 
Consequently» the entire range of SMCS commands is available to a 
SYCOM user with this command syntaxe 


Syntax: 
<sigqnal character> = = on op <SMCS commarco = = eo oe an ee —_ 7 en an a ee oe ee oy Ss we eS ee a owe a me | 
I--- <attribute> --<-! 
Semantics: 
signal character The signal character assigned to SMCS. 


SMCS command Any SMCS command which is vatid from a userwsystem 
terminal. 


attricute Any attribute that is required by the SMCS 
commande | 


Examples: 


STATUS 
*FILE DMPALL 


BS oe i ed Ge ea iiaes 
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SMCS WCP Command String from User-System 


This command syntax initiates directives to the user-system MCP 
for processinge By prefixing the ccmmand string with the signal 
character of the tiocak SMCS» the network controller message 
switches this command string to the user=system SMCS which in 
turn zips the string te the MCP for processing under the 
following rules» assuming that the terminal is a remote ODT. If 
the ZIP option is inctuded or the user is not togged-on»s then the 
commard strina is zipred unsecured> otherwise» the command 
string is zipped secured. | 


syntax: 


<signat character> ee3e72e4-e--~ <MCP COahand> SSS trrssees reer ese ea 
age © © ce ad I= <attributes> -] 


semantics: 
signal character The signal character assigned to the SMCS. 


ZUIP] Used by the SMCS to zip the MCP command as an 
| unsecured control strirg. | 


MCP command Any MCP command which is valid from ae work 
Station. Refer to Arprendix F in this manual» or a 
List of these MCP coftaands. | 


attricute Any attribute recuirec by the MCP command. 


Examptes: 


*Z PC DMPALL ; 
*Z EX DMPALL 
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SMCS Cogmand String from Server~Systes 


This command syntax allows 42 terminal user on the user=system to 
give commands to the server~systea SMCS for processing. Each 
commard entered must be prefixed with the current signal 
character for that SMCS and that signal character must differ 
from that of the userswsystem SMCS. ALL messages with this signal 
character are intercepted by the network controller §$ and 
immediately sent to the SMCS for precessing. Consequently» § the 
entire range of SMCS commands is avaitable to a SYCOM usere This 
commard syntax is only valid when sr SMCS its running in the 
server~vsystem. 


Syntax: 


<signal character> “~~ <SMCS command> ce7-7"> awe wwe wee ewe eee eeene | 
In--~ <attributes> =--] 


Semantics: 


signal character The character assigned to the server-system 
SMCS. 


SMCS comaand Any SMCS command which is valid froa a user-systen 
| terminal. 


attribute Any attribute that is required by the SMCS 
commande 


Examples: 


$ FILE CMPALL 
$ STATUS 
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SMCS MCP Command String from Server-Systes 


This commend syntax allows certain MCP commands to be sent to a 
serverssystem for processing» These MCP commands can be entered 
from either the user-system ODT or from one of its terminals. 
| Alt replies to these commands are returned to the userwsystem 
SYCOM program which causes them to be displayed on an appropriate 
device. Certain MCP commands require a eusercode/password» 
prefixed to the desired MCP command» which 15 known to the 
serverwmsysteme This command syntax is anly valid when an SMCS is 
! | running tn the server~system. | | 


Syntax: 


I i] I 
Pe Ziel Ma ie LS SUuSsercode> SSE <es=Seseeor === 1 
| | i-- <password> ===] 


Pasa = <MCP CONGaAnd> = Ses — 99 oe SSS S39 9S S95 Sse See SS SSS e453 Seem Sees] 


] | | 
f--" <attributes> -=~-] 


| Semantics: 


Signal character The Signal character assigned to the 
server=system SMCS. 


ZCIP] Used by the SMCS to zip the MCP command as an 
unsecured control strirge 


userccde A symbol which consists of from one to eight 
characters that identifies the user. 


i passwerd A unique character strirg used for identification 
| purposes to meet security requirements. 


MCP command Any MCP command that is vatid from an ODT or 
terminal. 


attricute Any attribute reacuirec by the MCP command. 


Examples: 


Sb MX 
$ WY 
# US NY/USER PD =/=_— 
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Table 471 contains a summary of the functions of the SYCOM 
commerdse Refer to the command descriftions tn this sections for 
command syntax and option details. 


Table 47°71. Summary of SYCOM Coamands 


Command Station Function 
ABORT Any Abort a PUT or FETCH file transfer. 
ADD Any File transfers CPUT or FETCH). 
BUFFER Any* ipeerroqace or change the buffer size 
for file transfers. 
BYE Any Station log-coff from SYCO™M. 
CL OOT Clear peripheral device. 
CONNECT Any Request establishment of a terminal to a 
server~systen SMCS. 
COPY Any File transfers CPUT or FETCH). 
(- cp | OOoT Inform SYCOM of Not Ready peripheral. 
- 
7 DEBUG Any* Start/stcp input/output message tracing. 
DISCONNECT Any Request for terminal disconnect from the 


server~system SMCS. 


EQJ OCT Causes SYCCM to go into an orderly shutdown. 
FETCh Ary File transfers Creceive a file from other 
system). 


GROLPSTIZE Any * Sets groupsize for file transfers. 


“re minoucanainainy muulm naan secre eae seh 


LIST 


LCG 


LP 


OFFLINE 


ONLINE 


PHONE 


PROGRAM 


PUT 


QS 


READ 


RESTART 


RY 
SIGNAL 
SIZE 
STOP 


SV 


SYSTEMID 
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GROUP 


Any 
Any* 
OOT 
OCT 


OOT 
Any* 


Any* 
Any 


Any* 
ODT 
ODT 
ODT 
Any 
Any* 
OOT 
ODT 


Any* 
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Display selective system information. 


Display a list of Data Comm error counts. . 


Inform SYCCM that a line printer is 
Not Readye 


Cause SYCO¥ to break the connection to a 
server~systete 


Establish 2 server~msystem connection. 
Establish cr clear phone number. 


Set or interrogate value of program 
parameter. 


File transfers Cplace a file on the other 
system). 


Change netxwerk controttler queue depth. 
Open ard trarsmit card input file. 
Disconnect Line» initialize» and standby. 


Inforn SYCCM of available peripheral. 


Change the SYCOM signal character. 
Change waximum message block sizee 
Cause SYCOM to shut down immediately. 
Stop transawitting and save file. 


Irterrecgate or change the value 
of SYSTEMID. 
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TRACE Any* 


USER Any 


WAIT Any* 
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Start/stop SYCOM I/0 disk tracing. 


Log a user cn to the SYCOM program. 


Irterrcgqate ocr change the value of 
the wait ferameter. 


SYCOM status inquiry. 


Any = Any SYCOM station 


> 
a | 

“< 
% 
i" 


Any SYCOM station can interrogate the 


value of this comamarce Onty the system 
ODT or a remote ODT can change it. 


ODT = The system ODT or a remote ODT. 
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OPERATING PROCEDURES 


GENERAL 


This section provides system and terminal operating procedures 
used for the cperation of a SYCOM system with and without Local 
terminalis and/or in conjunction with the Supervisory Message 
Control System CSCS). System operzgting procedures are stanted 
toward operation of SYCOM for the curpose of Remote Job Entry 
CRJED type functions and the asscciatec syste control functions. 
These procedures present all aspects cf SYCOM operations from 
nNitialization thru controiled shutdcwhe 


Locat terminal operational procedures are separated into two (2) 


categories» terminals under SYCC®¥ control and terminals under 
the control of the SMCS. These procedures provide coverage of 
atl terminal operations within the scope of SYCOM) from sign-on 
to signoff. Actual input/output message text is used in the 


examples to provide a feel for the ease of operation and what can 
be exrected by a user of the system. 


SYSTEM OPERATING PROCEDURES 


The system operational procedures presented here are intended to 
provide a User System operator with sufficient information for 
operation of an interactive system using SYCOM. Operation of the 
associated Network Controtler is triefly discussed. In additions 
Suggestions on the use of certain basic SYCOM commands and their 
options are exemplified. | 


PRELIMINARY PROCEDURES 


Before the SYCOM system is executed» the user needs to be aware 
of a few system variables that must te considered. First there 
are “program switches” which way be used to invoke certain 
optional features. Second there 1s the “parameters” fite which 
is used to waintair SYCOM"'s variable control functions and 
processing attributes. The follcwing procedures must be 
performed to make the SYCOM system operational: 


1. set the SYCOM program switches as appropriate. 


Ze Prerpare a parameters disk cr card file as required. 
 Coptional)d 


a5 Creste a CSYSTEM) /MAKEUSER file» 14f required for file 
security. 


BURROUGHS CORPORATION a — COMPANY CONFIDENTIAL 
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he Setup the MCP program name table. Coptional - for 
automatic MCP execution cf Network Controller when 
SYCCM 1s excuted) 


Ss Assign system program pricrities. 


Progréem Switches 


Progréem Switch 0 Setting Program ‘Snitch 0 te 4 causes the SYCOM 
progréem to omit the cisplay of beginringwof~job messages until 
the tink to the remote system has been established. If the 
Low-crder two bits of the switch are sets the DEBUG/DISK_TRACE 
trace facility wilt be activated from BQJ untilthe parameters 
file is read ty the SYCOM program. As soon as the parameters 
file has been read» the values cortained in the parameters file 
will be used to control the OEBSUG/CISK_TRACE trace facilities. 
This feature is intended to be used ter debugging purposes. 


Progréem Switch 1 If Program Switch 1 Is set to ils then the 
open-cnwbehalf-of file security mechéerism wilt not be used _ (for 


disk files» This witt cause SYCOM to use the Mark 7.0 file 
security mechanismse This switcr is only examined when 
processing operatcr input. Chancing procram switch 1 to any 


value than 1 will restore the nornal mode of operation with file 
security. 


Progrgm Switch 2 Program Switch 2 is only valid when the TRACE 
parameter is specified in the parameters file or the TRACE ON 
command is entered to the SYCOM program at the system ODT. 


Setting Program Switch 2 to 0 causes the SYCOM program to trace 
intersystem SYCOM controt messages orlys Setting Program Switch 
2 toe 15 causes the SYCOM program tc write all messages and data 
Lines to the CISK_TRACE file. Settirg Program Switch 2 to a 
value between 0 and 15 causes the SYCOM program to write n number 
of data lines to the CISK_TRACE file>» where n is the values 
specified for Program Switch 2. 


Progrem Switch 3 If Program Switch 2 is set to 3» then the output 
from the SERVER stations is included in the CISK_TRACE file tf 
the TRACE option is set or in the LEFLG file if the DEBUG option 
is sete 


Program Switch 4 Setting Program Switch 4 causes” the SYCOM 
program to suppress the file transfer messages displayed on the 
system ODOT. The value of Program ‘Switch 4 determines which 
message is to te suppressede The messages that can be suppressed 
follow. 
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Messaq 
Number 


e 


Transfer Message 


"<filename>™ START SENDING 
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"<filename>* START RECEPTION 
"<filename>™ SENT <n> RECORDS 
"<filename>™ RECEIVED <n> RECORDS 


Table 3-1 shows the possible combinations 
file transfer messaqes. 


for suppressing the 


Table 3-1. Combinations of File Transfer Messages 


Vatue cf 
Program 

Switch 4 
Cin hex). 


ara 


-— 2 28 Of 4 ee ee ee ee oe 


I 
i 
1 


| 
+ 
I 
i 
i 
I 
i 
I 
} 
i 
1 
| 
I 
I 
i 
i 
i 
j 
i 
i 
f 
{ 
| 
| 
J 
J 
i 
j 
i 
{ 
I 
| 
j 


Message Suppressec I 
Cby message ne rek2 ] 


I 
11 2 4 3 «3 4 4 
coe powmeanpowewapwo eam} 
{ i 
I i i i 
I i 1 xd 
{ i i i 
| 1 x | ! 
I 4 i 
i x tx 
i i i i 
1 xX J 1 i 
i i i 
1 x J a 
1 I 1 
ix | xX | 1 
i i i 
Dx FX F xX] 
I i i i 
xX | i i 
I i i i 
x J i 1 xo] 
| i i 
X J 1x t i 
i i 1 i 
Xx J 1x :x 
I 1 I 
Xx § X ] i I 
bo | i i 
X | X J I x 
I { i 
KX § X FX J 4 
I I i 
KX | XI 1 xX 4. 
: + 
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The "X™" indicates that the wessage is suppressed. 


7 


If Pregram Switch 4 equals ag0a- then no messages are suppressede 
If Pregram Switch 4 equals @Fad» then all the messages’ are 
suporesseds 


Program Switch 4& only applies to the local SYCOM program and does 
not affect the file transfer messages displayed by the SYCOM 
progréem on the other system. 


Progréem Switch 5 Setting Program Switch 5 to 5S causes the SYCOM 
program to automatically initiate a menory dump and print” the 
DISK_TRACE file whenever the SYCCM systewt appears to out of 
phase. 


9ettirg Progra Switch 5 to 5 alsa céguses the SYCOM program to 
automéeticaliy print the ODISK_TRACE file when the file becomes 
full. The SYCOM program continues writing trace records 
beginring at record number 1 in the CISK_TRACE file. 


Progrém Switch & Setting Program Switch 6 tc 6 causes the SYCOM 
progrem to dispiay tne statistics of the SYCOM tog on the system 
ODT whenever the DISK_TRACE file becomes full. The SYCOM program 
begins writing trace records th the CISK_TRACE file at record 
number 1. | 


Settirg Program Switch 6 to 7 causes the SYCOM program to 
automéeticaily write the SYCOM Log te the program INQ file when 
the DISK_TRACE file becomes full. 


Program Switch 72 Setting Program Switch 7 to 1 causes an entry in 
the statistics file to be generated fer files that have been 
received from a ramote system. 


Settirg Program Switch 7 to 2 causes an entry in the statistics 
fite to be generated for files that have been transmitted to a 
remote system. 


Setting Program Switch 7 to 3 causes an entry in the statistics 
file to te gererated for any fite transfer that has occurred 
Ciee. both sending and receiving). 


Workfile Naming Conventions 


The family néme and pack id of the SYCOM workfiles CNEWPARAMS» 
PUTQGFILE» INQ» OUTQ» STATISTICS» RJE_G» LINK_@» DISK_TRACEs» and 
OLDTRACE) are determined from the farily name and pack id of the 
PARAMETERS 


The fémily nawe and pack 1d of the pérameters file are determined 
as follows: 
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1. If any file equation has been wade for the PARAMETERS file 
| by the operators then the actual name and/or pack id 
specifiec will te usede For exzenple: | 


ae EX SYCOM FILE PARAMETERS PID USER-DISK3 | 
be EX SYCOM FILE PARAMETERS NAME USER.PARMS? | 
ce EX SYCOM FILE PARAMETERS NAME USER«PACK/HUB/PARAMS3 


The actual files names for the PARAMETERS file resulting 
from the file equations shown abcve are as follows? 


ae USEReDISK/<sycom>/PARAMETERS 
be USERePARAMS 
Ce USERePACK/HUB/PARMS 


Ze If no file equation has been made for the PARAMETERS file by 
the operator» then the pack ic and the family name will be 
taken frces the actual name of the SYCOM program. For 
exaaples a 


as EX SYCOM 
be EX HUB.SYCOM 
Ce EX DC/SYCOMIC/SAL 


The actual names for the PARAMETERS file resulting from the 
execution statements above are as follows: | — 


ae SYCOM/PARAMETERS 
be  HUS.~SYCOM/PARAMETERS 
Ce DC/SYCOMLO/PARAMETERS 


All werkfiles wittl be changed by SYCCM to have the same _ family 
name and pack id as the parameters file. Thus» many copies of 
SYCOM may be run on a single machine and the workfiles may be 
Located on different racks as desirec. 


Since the orly way to force printer backun files to a user disk 
is By using the MCP "8D" commands» SYCOM cannot force the DEBUG or 
LIST files to a4 user pack. The family name of these files is 
changed to the same family name as the other workfiles so that 
there will be no confusion over tte tabeltling of printer files 
from multiple copies cf SYCOM. 


Creating the SYCOM Parameters File | y, 


When the SYCOM program is executed fcr the first time or if the 
SYCOM PARAMETERS file is not on disk» a parameters file must be 
created. At bkeginningwof"job the S¥COM program first checks for 
the parameters file on disk. The actual Label of the parameters 
file is determined as described abovee If the PARAMETERS file is 
present and cf the correct versior» SYCOM uses the parameters 
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specified in the disk filee If the cisk file is not presents the 
SYCOM programs checks for a card file labeled NEWPARAMS. If the 
card file is rot present the progrem Looks for ae disk § fite 
labeled NEWPARAMS. If the card file or disk file labeled 
NEWPARFAMS is present» then the SYCOM program uses the parameters 
specified in the card file to create the PARAMETERS disk file. 
If the card file and disk file lLahelec NEWPARAMS are not present» 
the ‘SYCOM prcgram prompts the user to enter the parameters or 
"END" Csince all parameters have a default value) from the ODT. 


Once the parameters have been enterec» the SYCOM program creates 
a disk file Labeled PARAMETERS for use the next time the program 
1S executed. The PARAMETERS file dces not need to be recreated 
unless the file is removed. remcved or requires permanent 
changese The parameters may be changed cr irterrogated for the 
current execution of SYCOM by entering the farameter name and a 
value in an ACCEPT messagee To create a new PARAMETERS file» the 
following steps should he followed: 


1. wake the required changes to the NEWPARAMS file. 
2 « Remove the PARAMETERS disk file. 

36 Terminate the SYCOM progran. 

4 Re~execute the SYCOM prograr. 


Refer to SYCCM Parameters» in Section 6 page 15» for a 
description of the SYCOM parameters. 
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Preparing the NEWP ARAMS Card File 


The NEWRRANS. FileSanbee-caued Fale: The following is an 
example of a NEWPARAMS card file. | - cu 


2DATA NEWPARAWS © 


SYSTEMID = USERI 


y 4 | 
BUFFER = 1100 z Allows 3 ccde records per transmission. 
DEFALLIPSEUDOSIGNAL $ 2 Use “€" irstead of *.* 
GROUPSIZE = 1 Z Defauit is 9 
NOFS Z For Host RJE 
NOFTP 4 
NOPRCGRAM yA 
QUEUESIZE = 6 % The default value is 4. 
WAIT & The default 1s no waite 
TIMECUTS = 0 2 Default is 11. Eliminate message 
DEBUC % Default is false 
TRACE yA 
TRACEAREAS = 25 Z The default value is 20. 
TRACEBA = 8 % The cefault vaiue is 10. 
TRACERB = 5 2 The default value is 4&4. 
ENC Z Optional. 
PEND 


The cuestion mark (7) character ir the above examole represents 
an invalid character for 80-column carcse The percent sign (2%) 
character causes the SYCOM program to stop scanning the record. 
This zilows user comments to be ircluced in a parameter record. 


The above example does not show all of the available SYCO™M 
parameters. If a tarameter is net specified in the card file» 
then the SYCOM program uses the default value for the parameter. 


Preparing the NEWPARAMS Cisk File 


The NEWPARAMS disk file can be created by using the CANDE 
progrém. The parameters can be ertered intc the NEWPARAMS file 
in free-form format. The oercent sion €Z) character can be used 
to denote the beginning of comments for documentation purposes. 
The fcllowing CANDEwcreated disk file shows what the NEWPARAMS 
file can tock ttike. If CANDE 185 used to create the NEWPARAMS 
file» it may te cf type DATA or SEQDATA. 


The following is an example of a NEWPARAMS disk file. 
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yA 
% Séempte NEWPARAMS files 
Z 
% Lecwerwcase entries are allowed ir parameters file for 
y 4 perameterse 
yA 


systemid = 81885 Special characters are not allowed. 
If this parameter is not specified» 
the SYCCM program wiil use the MCP 
HOSTNAPE. 

defaultpsecdcuosignal & Controls the SYCOM pseudocsignal 


character. Default is "."- 


Controls the nugber of files that 
may be sent at ore time when sending 
an entire familiy of files. 

Default is 9. 


groupsize = 5 


buffer = 1950 The maximum buffersize is 1950. 


inbuffers = 5 Nusgber cf buffers assigned to 


file “IN" at 3B0J- Default is 3. 


ee sa 
Shh ae 


inbuffers = 5 Number cf buffers assigned to 
file "IN" at BOJ. Default is 3. 
program Allcws program~to~SYCOM functions. 
Default is trues 
% noprogram Inhibits program~to~SYCO0M. 
Defautt is false. 
Z noftp Inhibits file transfer. 
Default is false. 
queuesize = 8 Controls the number of messages 
that céen be written in the “LINK” 
file. Range is from 1 to 15. 
Default is 4. 
timeouts = i11 If n timeouts occurs then the 


y 4 


wait 


nowait 


% trace 


NMNNRNRNMMNNNMHNNMNAM HMMM RM RM NM NM RRM NM HRM NMA NR NMR RMN NM RM NM PR 


remote SYCOM is consider off-line. 
Default is il. 


Prevents SYCOM from going to EOJ 
when a disconnect message is 


receivecej Oefault is false. 
Altows SYCOM to go to EQJ when 
wher cisconnect message 1s 
receivece Default is true. 


Allcws cisk tracing. 
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Default is true. 


Inhibits disk tracing. 


notrace 
Default is fatse. 
tracerb = 4 Records~perblock for the trace 


file. Cefault is 4. 


Blocks~pertareas for the trace 


traceba = 10 
. | file. Cefault is 10. 


traceareas = 20 Number of areas for the trace 
file. Cefault is 20. 

% debug Allows printer tracing. 
Default is false. 

% nofs File serarators are aliowed by 
default. This parameter is used 
in conjunction with the Host RJE 
programs which dees not allow file 
separatcrse 

end Ontiorel. Signifies end of 


parameters. 
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Entering the Parameters Threugh the COT 


If the SYCO¥ program does not find a disk file labeled 
PARAMETERS» a card file tabetled NEWPARAMS» and a disk file 
Labeled NEWPARAMS» the following wtessage is displayed on the ODT. 


2 SYCOM =<job #> ENTER OPTIONAL SYCOM PARAMETERS OR END 
Z SYCOM =<job #> ACCEPT 


The SYCOM program is then ready to éccept parameters from. the 
ODT. The parameters are enterec in freeform format and are 


terminated by an "ENO parameter. 


The parameters aust be entered with ACCEPT entries in the 
following format: 


<SYCOM jot #> AX <parameter keyucrd> [=<vatlue>] 


(<parameter keywxnord> C=<value>]...- 
END 


Multigctie ACCEPT entries are atloned. The sequence 3s 15 
terminated by the “*ENO™ parameter. 
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The SYCOM program checks each parameter for syntax and validity. 
Any incorrect entry irvalidates all entries in that ACCEPT entry. 
Correct the error and rementer the ACCEPT entry. If the default 
value for a parameter is desired-p it %s not necessary to include 
1t in the ACCEPT entries. 


The parameters are described in Section 4-e 


Creation of the CSYSTEM)J/JUSERCODE File 


The system utility program “MAKEUSER™ ts used to create and 
maintzined the CSYSTEMI/USERCODE filte-e This file contains a list 
of ail valid usercode/password conbinations for the system. 
Refer to the “Systems System Software Operational Guide™ for 
detailed descriptions of the file arc its creation. 


setup MCP Program Name fable 


In order for SYCOM’s Network Coantrcller to be automaticalty 
executed by the systems» it 3s necessgry to establish the tdentity 
of this Contrcller in the “MCP Progra@# Name Table”. To do this 
is simple» enter the following MCP command: 


“=> CM C USER/NC<etx> 
NETWORK CONTRCLLER CHANGED FRCM "" TQ “"USER/SNC*™ 


The controller name “SYCOM/NC” is cf course 2 user optionat name 
and is therefore only representative. The actual Controller name 
selected by the user would be substituted as required. 


To verify that the correct Network Controlter I/D is in the MCP 
Name Table ("C™ slot)» the followine MCP command can be entered: 


“-> Wh C<etx> 
C = "USER/NC™ 


Assigning Program Priorities 


For crtimum system responses it is recessary that the system's 
Network Controttler and SYCOM rtn at a “*"high™ priority. 
Therefore» to ensure that the MCP automatically executes these 
programs at their optimum priorities» the following MCP commands 
are used to permanently assign a pricrity of “15” to the Network 
Contrctler and a pricrity of %12" tec SYCOM: 


==> MQ USER/NC PR 15<etx> 
"USER/NC™ MODIFIED 


=-> yO SYCOM PR 12<etx> 
"SYCOM" MODIFIED 
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Execution of SYCOMS ‘Without SMcS 


To use the SYCOM system without the benefit of a SMCSr the system 


operator simply enters the execute SYCOM commend as shown below. 
The MCP automaticaily executes the essociated Network Controlter 
program Cproviding one is in the “C™ stot of the MCP Name Table) 
when the first remote file cpen is iritiated for the controller. 
Both SYCOM and the Network Controller should be run at a priority 
which ensure adequate response tises to the user of the system 
Csee suggested priority values below). = 


It is the option of the user whether cr not SYCOM is executed 
With a “usercoce”™. If it is desirec to force SYCOM"'s work files 
off the system disk» then it may be executed with a privileged 
userccde whose default pack"name is the desired disk~cartridge or 
disk~packe Otherwise» SYCOM must be executed in the manner shown 
In the example below: 


“=> EX SYCOM<etx> 
SYCOM =<job #> BOJ. PP=12» MP=12 TIME = 08:2147251.2 


During the beginning of the initialization phase if SYCOQM cannot 
Locate the “"SYCOM/PARAMETERS™ file or cisk» it attempts to obtain 
New pérameters from a disk file Labeled "SYCOM/NEWPARAMS® or from 
the cérd reader C"SYCOM/NEWPARAMS” file). Should the disk § file 
not ke available or the card reader “rot ready"» or if there is 
no card reader» then SYCOM will tapse into the mode of accepting 
the rew parameters from the system ODT» When SYCOM is in this 
mood» the following messages are cisglayed in the OOT: 


% SYCOM =<job #> ENTER SYCOM CPTIONAL PARAMETERS or "END" 
SYCOM =<job #> ACCEPT. 


The system operator can then enter the appropriate parameters to 
alter the system's “default paraseters™ Crefer to Appendix G» 
“Parameters File Attributes"). The entry procedure 1s presented 
with “Enterinc The Parameters” ir this section. Although the 
"SYSTEMID™ parameter is not required» in some instances» it is 
stronoly sugcested that a represertéetive “system identifier” be 
entered with the parameters at this time. 


Once this file is established on disk» it need not be recreated. 


unless it is lost or requires changes. Chances to the file can 
made using either of the two methods identified. However» again» 
it %s necessary tc “remove™ the existing parameters file from 
diske Additionatly» this requires SYCOM tc be shutdown = and 
remexecuted if it is currently runnirgs else alt is in order. 


When SYCOM opens its Remcte Files» the MCP knows whether or not a 
Network Controller is running and takes the appropriate action. 
That is» if a Controller is running» then the remote file opens 
take flace and the system becomes operationale. If a Controtler 


is “not™ currently runnings then if the Controtler's name is in 


(fe a 
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the "CC" slot of the MCP Program Name Table» the MCP automatically 
executes the named Centrotler orcgrem and the following messages 
are disptlayea at the CDT: 


EX SYCOM/NC PT> 
SYCOM/NC =<job #> BOJ.»j PP=15» MP=15 TIME = 08215208.7 


If there is no Contretler name enterec in the MCP Program Name 
Table» then the following sessage is cisplayed: 


REMOTE FILE "TERMINALS" NEEDS A CONTROLLER 


The system operator ‘ust then execute the appropriate Network 
Contrecller by entering the following command: 


“-> EX SYCOM/NC<etx> 

SYCOM/NC =<job #> BOJ. PP=15»5 MP=15 TIME = 08:16:01.2 
The MCP displays the above "BOJ" messacse» permits the Remote File 
opens to accur and the system i185 operational. ihen this 
condition exists» the following cpticnal message is displayed on 
the system ODT: 

2 SYCOM =<job #> RUN DAY = THURSDAY 17 AUG 79 AT 08223: 31 
Upon completion of SYCOM'’s initialization phase and a successful 
connection astabdlished to a default Server Systems the following 


messages wilt be displayed on the User ODT: 


% SYCOM =<job #> xx** SYCOM 1[X.0-2 €30 JUL 79 142353) #**% 
NOW ONLINE TC REMOTE HOST = SERVERL 
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‘Execution of SYCOM$ With SMCS 


When SYCCM runs in cecnjunction witn the SMCS» it is automatically 
executed by S¥CS thru its "job spawning” facititye This occurs 
when the “first™ terminal user “"SIENS“ON" cr “"PASS's™ to SYCOM 
from a Local terminal. Or» the system operator may start SYCOM 
from the system ODT by entering the SMCS command “START SYCOM™. 
SYCOM executed by any other method with onty cause operational 
problems Cie@e» 2 copies of SYCOM executing at the same time). 


Prior to SYCOM*s operation under the SMCS» an entry must be made 
In the "SMCS/JC3S" file for SYCOM. &¢ sample entry is included in 
the “SMCS Software Operational Guide" for this purpose under the 
headirg “Editing The JOSS File". 7 | 


If during the initialization phase» SYCOM carnot Locate the file 
"SYCOM/PARAMETERS™» it attempts te obtain new parameters from the 
disk file "SYCGM/NEWPARAMS™ or the card reader CSYCOM/NEWPARAMS 
filed. Should this either file not te present» or if there is no 
card reader» then pYCcomM commences to accept new parameters input 
from the ODTj To sigral the system cperator cf this requirement» 
the fcllowing messages are displayed: 


2 SYCOM =<job #> ENTER SYCOM CPTIONAL PARANETERS or "END" 
SYCOM =<job #> ACCEPT. 


The system operator must then enter the appropriate parameters to 
override the system's “default paraaeters™ Crefer to Anpendix G» 
“Parameters File Attributes"). The parameter entry procedure is 
preserted with "Entering The Pzrameters"s this section. 
Although the parameter “SYSTEMID™ is not required» for some 
instances» it is strongly suggested that a representative "system 
identifier” be entered with the paraneters at this time. 


Also during the initialization phase» the following optional 
message is displayed on the User ODT: 


& SYCOM =<job #> RUN DAY = THLESDAY 17 AUG 79 AT 08223231 
Upon cogpletion of initialization éerd the successful connection 
to a cefault Server Systeme the fottcwing ressages are disptayed 
on the User OCT: 


yA SYcoN =<job #> w*e2 SYCOM [xX.0e2 €30 JUL 79 14253) #2 
NOW ONLINE TC REMOTE HOST = SERVERIL 


Common System Operations 
Once SYCOM has been executed» fro# either the ODT or spawned by 


the SMCS» most operating procedures are comacn to both modes of 
operation. These common operating procedures are oriented to ODT 
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input in the form of SYCOM parameters» SYCOM commands» and MCP 
directivese Following then are the common operating procedures» 
preserted in the sequence they are mcst Likely to occurs under 
individual heacings- 


SMCS Signal Characters 


In order for a SYCOM systems network toc function effectively» it 
is a requirement that the SMCS “signal character” for each system 
in the network to be a different chéracter. This can be easily 
accogrlished by mutual agreement when the SYCOM systen network 1s 
desigred. Each system's SMCS should have a specific character 
which is made known tec atl system userse Obviously» if the SMCS 
1s not utilized» this ts not necessarye 


If during actuat system operations it 18 found that a SMCS signat 
character is undesirable for any reascns it can be changed while 
online. Thais can be accomplished by entering a "signal character 
change commanc™ fro@ either a tocal cr remote source. For actual 
details» refer to the “SMCS Software Cperationsal Guide™. 


Entering the Parameters 
The farameter definitions tlisted telow can be entered to SYCOM 
from the system ODT. To do SO» they can be entered on severat 


Lines using the following *Acceot™ prceccess: 


“-> <sycom jot #> AX <parameter keynord> er" [=<value>] s7"--=> 


“<---- “---> [<parameter xeyword> 7"~ [f=<value>]J].ee..]}] END 


Each parameter 1s validated and the system cperator is informed 
of any iltegal parameters encounterec during the parsing of the 


parameter data. if the parameters are specified in a disk or 
card file "SYCOM/NEWPARAMS"» then they may also extend over 
several recorcs (see example). Comments on any record must be 


prececed by a "Z". 


NOTES ALt parameters have default values. 
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BUFFER Parameter 


This parameter defines the size» ir bytes» cf the used in SYCOM 
communications with the other systeune The buffer size should be 
Large enough to handle the Largest tessage» and possibly achieve 
a blocking factor for multiples of a record. 


Syntax: BUFFER = <integer> 


The default buffer size is 1950 €a compile time constant) and the 
maximum alloweble size is 1950 bytes. (This parameter directty 
relates to file transfer buffer size and not RJE buffer size.) Be 
advised howeverep that this buffer size must be equal to or 
greater than the maximum record size tc be trensferred aultiplied 
by 2» plus 2 needed for nonsdata record translations. 


DEBUG Parameter 


This parameter indicates that the prirter tracing mechanism is to 
be utilized to produce a record of SYCOM*s I/O message activity. 
CThe cefault is “no printer trace”™.) 


Syntax: DEBUG 


DEFAULTPSEUDOSIGNAL 


The DEFAULTPSEDUQSIGNAL parameter is used to permanently assign a 
value to the SYCOM pseudowsignal character. The first nonwtblank 


character encounterec after the farameter 1s taken as the. 


pseudosignal character. (The default is ".".) 


Syntax: DEF AUL TPSEUCOSIGNAL anew: £eharacter> 7.-=ss<+=<=] 


END Paraseter 


Entering an END in the parameter string terminates the parameter 
input Pie seae 


Syntax: <sycom job #> AX <parameter string> END 
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GROUPSIZE 


The GROUPSIZE parameter is used to ccrtrol the number of files 
that will be sent at one time wher sending entire families of 
files. Tne SYCOM program will transmit a nuwber of files equat 
to the groupsize and ther check to see tf another user has files 
to ke sent and» if so» witl transmit a number of files for the 
second user equal to the groupsizes before continuing with the 
secord and subsequent groupse (CThe cefault is 9.) 


INBUFFERS 

The INBUFFERS parameter controls the number of buffers that are 
assigned to the file “™IN*" at &O0J.- The file "IN" is used for 
input when doing fite transfer and increasing the number of 
buffers can speed up the file transfer process. CThe defauit 1s 


5) 


Syntax: INBUFFERS = <integer> 


NOFS Parameter 

SYCOM wiil not send a "FS1" or *FS2" Cfile separator) to the 
other system when sending card imaces Crelevant to RJE). (The 
default is false.) 


syntax: NOFS 


NOFTP Paraseter 


This parameter inhibits File Transfers if either system has this 


parameter specifiede The purpose is clear» when specifieds “no 
File Transfers are to occur for this system. There is no quick 
way to overcome this user restricticn. The only recourse ts to 


Shutdown SYCOM» remove the Parameters file and correctly enter 


the desired parameters. (CThe default is false.) 


Syntax: NOFTP 


NOPROGRAM 


The NOPROGRAM parameter inhibits fprogram@tosSYCOM # functions. 
CThe cefault is false.) 


Syntax: NOPROGRAM 
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NOTRACE 


NN 


The NCTRACE parameter inhibits tracirg at a of~job.e. (The 
default is true.) 


Syntax: AOTRACE 


NOWAIT 


The NOWAIT parameter allows SYCOQPM to go to endtof~job when it 
receives a disconnect messagee (CTthe default is true.) 


Syntax: NOWAIT 


OUTBUFFERS 


The OUTBUFFERS parameter controls the number cf buffers that are 
assigned to the file "OUT" at &0J. The file "QUT" is used for 
cutput when doing file transfer and increasing the number of 
buffers can speed up the file transfer process. CThe default is 
Ze) 


Syntaxs QUTBUFFERS = <integer> | 


PROGRAM Parameter 


This farameter is specified when SYCCOM is to perform program-to- 
SYCOM functions. The "record size™ parameter Limits the mnaximun 
Length of these messacese (The default is true) 


syntax: PROGRAM 


QUEUESIZE Parameter 


This parameter is used to establish the initial QUEVESTIZE default 
value. The vatue is changeatle at any time during SYCO™M 
operation via the *Q5" command. The winimum value which can bdDe 
specified is "4" and the maximum ts "15". (CThe default is 8.) 


Syntax: QUEUESIZE = <value> 
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SYSTE*ID Parareter 


This parameter is used to sndecify the name of the User Systeme A 
Systemmid can te comprised cf frcm ore to seventeen characters. 


Syntax: SYSTEMID = <system-id> Ceeges» USERID 


If the SYSTEMIC is not specified the MCP HOSTNAME will be used. 


TIMEQUTS Parareter 

This parameter establishes an “interval” for the assumption that 
the remote system has gone “*offlire™. A value of "0" inhibits 
this function. (CThe default is 11.) 


syntax: TIMEOUTS = <number> 


TRACE Parameter 


The usefulness of this parameter is to specify “disk tracing” at 
SYCOM initialization. The default is no tracing initiated. 


Syntax: TRACE 


TRACEAREAS 

This parameter is also specified in cenjunction with “TRACE*. It 
1s used to specify the "number of areas” for the disk trace file. 
The default value is "20". 


Syntax? TRACEAREAS = <value> 


TRACEBA Parameter 

This parameter is also specified in conjunction with "TRACE". It 
is used to specify the “blocks per area™ for the disk trace file. 
The default velue is “10". 


Syntax: TRACEBA = <vatue> 
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TRACERB Parameter 

This parameter is specified In conjurcticn with "TRACE". It 1s 
used to specify the “records per block” for the disk trace  § file. 
The default value is “4% | 


Syntax: TRACERB = <vatue> 


WAIT Parameter 


This parameter is used to prevent SYCOM from going to “*end-of-job 
when it receives a “disconnect messace”-. SYCOM will disconnect 
and léerse into a “offline/idle™ state. (CThe default is fatse.) 


Syntax: WAIT 
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re Xe 
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ne 


The fcllawing is a Listing cf a sample NEWPARAMS file. 


This file “*<sycom>/NEWPARAMS" can be used at BOJ instead of 
entering parameters from the SPC. 


If the file “<sycom>/PARAMETERS”™ is not present at BOJ 
THEN sycem Looks for a card file “<syco#w>/PARAMETERS™. 


If this card file is present then it will be used to create the 
new “<sycom>/PARAMETERS*” file. If» howevers tne card file is not 
present them sycom wilt look for a similartly~named disk file. 


Onty aif netther card nor disk file 1s presents then SYCOM will 
request operator input for the new parameterse Note the use of “% 
€s a comment delimiter. Also fcr 10.0 more than one ACCEPT is 
allowed» enabling any number of parameters to be entered. The new 
parameter “END™ wilt terminate the ACCEPTing of any further 
fCarameterse | 


Recommended parameters for SYCOM on USER7 
systemid = slave? special characters NOT allowed 

IF this parameter is not specified 

THEN the HOSTNAME from the MCP will 

te used- The "09" stationid message 

will be sent to the remote systen 

In any case@e: 


We rN HN HR Nw 


prograa for SLAVE/BACKUP.~ A file <sycom>/0UTQ 
will ce opened INPUT for reading input 
from @ program such as SLAVE/BACKUP. 

If this parameter is not specified THEN 
orcgqrzm input can be enabled by use of 
new PROGRAM cormand. 
default = FALSE} added for completeness 


Dee WN HN 2 


noprogram 


buffer = 1950 4 w@aximum = FILE TRANSFER_MAX_BUFFER 
which is a compile time constraint 
and which could/might be returned 
te dynamic memory instead of static 
mMERCrysr 1e@e the way it was done 
befcre tne implementation of NDL i/o. 
This parameters determines the maximum 
size cf the SENDING record. 
The size of the recetving buffer is 
a comcpiie time [€ only J] variable € 1950 ) 
It may now be dynamically 
changed at run time by use of the 
".»SUFFER™ command. If no new value is 
giver it wilt display the current value. 
The run time changing of the TRANSMISSION 
BUFFER size will NOT affect the 
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queuesize = 4& 
timeouts = 11 
trace 
2 notrace | 
tracerb = & 
tracerb = 8 
traceba = 10 
traceareas = 290 
z wait % default 
7 nowalt 4 default 
rs debug % default 
4 noftr % default 
ri nofs % cefault 


defaultpseudosignal . 


groupsize = 9 
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<sycom>/PARAMETERS on disk 


this is the default value. Maximum is ts 
QUEUESTIZE © MAX_MESSAGES in SYCOM ) 
contrcis the number of messages written 


to the LINK file. Its dependent variable 


MARKER_OFFSET» for determining when the 
"GOOD_LRESULTS™ mechanism is invoked» is 
€ MAX_MESSAGES / 2) # 1 

The cueuesize fay be queried or changed 
run time by ustng the “.9S" command. 
Any rew value will not be saved in the 
<sycom>/PARAMETERS file on diske 


this ts the default vatue. If this number 
of consecutive timeouts occur then the 
refcte system 1s considered OFFLINE. 


this is the default for DISK tracing. 
default = FALSE 

default = 4 records per block 

4 * 132 = 528 


540 = 180 *« 3 
8 records per block = 1056 

6 sectors at 180 bytes = 1080 bytes 
default = 10 blocks per area 
default = 20 areas —_ 

4 # 1C * 20 = 800 records in DISK. TRAG 
FALSE 

TRUE 
FALSE 


FALSE» is ee file transfer is allowed 
FALSE» i2 @e file separators are sent. 


2 This parameters is used in conjunction with 
%Z HOST/RJE C€ 38170C/B1800 9D which currently will not 
Z accept file Separators. 


this is the default € "." ) 
may be set to any non blank character 


this is the default € = 99/10 ) and is 
number of files sent in group with in a 
family of files being transferred. 

NeB. S39 is the size of the PUT QUEUE file 
If this parameter is set to 1 only one 
family member will be sent with checking 

for any other file transfer requestse 

If» however» it is set to the maximum 
value cf 99 then no other file transfer 
requests will be honoured until the 
whole famity has been transferred. 


inbuf fers 


outbuffers 
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% This is the default value. It can be set 
%Z to any other value and 1s the number of 
%Z buffers allocated to the file <sycom>/IN 


~ This is the default valuee It can be set 
% to any cther value for the number of 
%Z buffers ailocated to the file <sycom) /0UT 


end Z This is a required parameter if the 

Z parameters are being entered from the ODT 
Z It is the last parameter and is entered 
% to tergrinate the tist of parameters. 
2 It optional if the parameters are being 
% read from the <sycom>/NEWPARAMS file. 

Z Ne.B. The following parameters can have their value changed at run 

% time by the SYCOM command follcuing the farameter:- 

yA tuffer buffer 

z debug debug 

% croupsize groupsize 

z crogram crogram 

y4 roprogram program 

y4 cueuesize qs 

% systemid sSystemid 

“\ yA trace trace 
ft 4 notrace trace 

4 wait wait 

y 4 nowait wait 

yA Any SYCGM station can interrcgéete the value of any of the above 

2% parameters at run time with any cf the above SYCOM commandss Only 

Z stations declared as ODT € or CHANGE*"d by the SMCS ) can alter any 

2 cof the valuese- The altered value is valid until the next alteration 

% or SYCOM ECJ- At next SYCOM BOJ the values will revert to their 

2 previously declared values cortaired in the <sycom>/PARAHETERS file 

% Te permanently change the values in the <sycom>/PARAMETERS file it 

% must be reroved ard rewcreated. 
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RUN TIME TRANSMISSION 8UFFER SIZE IS 1950» RJE SIZE = 400 


DEBUG CFF 
GROUP SIZE IS 9 

PROGRAP INPUT ENABLED 

QUELE SIZE/OFFSET = 4/3 

SYSTEM ID = "SLAVES " 
TRACE CN 4 * 10 * 20 = 800 RECORDS 


WAIT OFF 


a, 


SeiesSbaaiecs Nan RE ily ete Rl ee Sah see EY oh eal athe tie i et a dh Dealesais cas cits Maid Sadar nenatl Rindet acai dct St Ne Ne ha ee ES i hae epee le ls at eae Li a lh! an ada ty tat wp alte ne ine i ie yA IRA PY et Spagetti, Be thy OEE ae Pt Spy ttl La 


BURROUGHS CORPCRATION | COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1800/B1700 SYCOM 
SANTA BARBARA PLANT Pe Se 2219 0458 CA) 


SYCOM Commands frcs the ODT 


The system operator 1s permitted toa communicate with SYCOM using 
the MCP "AX" facility. By entering certain commands Cexamples 
below)» the operator is also permitted to communicate with 
application programs ina Server Systems thru the “virtual 
terginal™ facility of SYCOM. A typical command session might go 
as follows» COT input is flagged with ""7">" and indented tLines 
are autput reply messages: 


“-> <sycom jot #> AX.WHAT<etx> 


SYCCM ITX-0-2 (30 JUL 79 14:53) ONLINE? 2 FILES QUEVED;, 
SENCINGS CJH)/#665 €7901/15325)> 

THIS STATION NOT CONNECTED 

LOCAL HOST = USER1I» REMOTE HOST = SERYVERI 


“=> <sycom yob #> AX.US MY/USER<etx> 


B170C/B1800 SYCOM IX.92-2 €3C JUL 79 14253) 
USER MY LOGGED ON TO SYCCw AT 1123122223 ON 22 AUG 79 


“=> <sycom job #> AXeFETCH *DMPALL<etx> 


FILE DMPALL START TRANSMISSION 
FILE "DMPALL™ START RECEPTION 
FILE "DMPALL™ RECEIVED 

FILE DMPALL END TRANSMISSICN 


“=“> <sycom job #> AXs»PUT CMY)/#3152 CNO LIST)<etx> 


FILE (MY)/€3152 START TRANSMISSION 
FILE “U/CMY)/DMPALL™ START SENDING 
FILE (MY)/#3152 END TRANSMISSION 
FILE "U/CMYI/DMPALL™ SENT 


==> <sycom job #> AX.-CONNECT<etx> 


CONNECT INITIATED £028] Aa aa 
CONNECT COMPLETED 


Bi8CC/B170C SMCS MARK 1X.0.C0D CO08/20/79 13240) 
CMY) LOGGED ON “SMCS~ AT 09236 O8/22/79 

YOU ARE AT STATION 13 CVIRTUAL) 

News? This is Serverl SMCS» gay I be of help? 


“-> <sycom job #> AXs.WHAT<etx> 
SYCCM IX20-2 €30 JUL 79 14253) ONLINE’ 2 FILES QUEUEDs, 


SENCING: CJHI/#605 €7901/15325)5 — 
THIS STATION CONNECTED (0281 Aa aA 


BURROLGHS CORPCRATION | COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP a ss B1800781700 SYCOM 
SANTA BARBARA PLANT | | Pa Se 2219 0456 CA) 


USERCODE= MY» LOCAL HOST= USER1» REMOTE HOST= SERVERI 


“==> <sycom job #> AXZ COPY DMPALL AS ADMP><etx> 
SYSTEM/COPY =<job #> BOJ. PP=9» MP=9 TIME = 09238:54.3 
"COPY 909" REMOVED | : 
"DMPALL™ COPIED FROM SYSTEPw DISK TO SYSTEM DISK AS ADMP 
SYSTEM/COPY =<job #> 1 FILE COPIED 
SYSTEM/COPY =<job #> EQJ- TIME = €9241233.6 


“-> <sycom job #> AX.~ODISCONNECT<etx> 
STATION DISCONNECTED 
--> <sycom job #> AXsFETCH ADMP<etx> 


FILE ADMP START TRANSMISSICN 

FILE "“U/CMY)/ADMP™ START RECEPTION 
FILE "U/CMY)J/ADMP™ RECEIVETL 

FILE ADMP END TRANSMISSION 


“-> <sycom job #> AX.~8YE<etx> 
CMY) LOGGED OFF SYCOM AT 0$3256211.8 ON 22 AUG 79 
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SYCOM PROERAM SHUTCOWN 


When SYCOM 18S running as a selfmsustaining entity Cwithout the 
SMCS)» the *.EQJ" command orovides the means by which an orderty 
Shutdcwn can occufr.e Once this ccrmand has been entereds alt 
subsecuent commands entered are rejected. An aporopriate “close 
messace™ 3s sent to the other SYCOM after the comoletion of ail 
inwprocess file transfers. SYCOM then sends a “disconnect 
message™ to the Network Controller ard goes to “*endtof~job". To 
initiate an orderly shutdown of SYCOM» the systen operator aust 
enter the following: 


“-> <sycom job #> AX.EOJ<etx> 
The following message is displayed ismediately on the User ODT: 
2 SYCOM =<job #> "EQJ" IN PRCGRESS. PLEASE SIGN OFF 


No further processing requests are accented. Any file transfers 
queued to process are allowed to corsrclete. At the point in time 
when there is no longer any SYCCM activity and att users 
Cincluding possiodle program input) are disccnrected» SYCOM goes 
to’ “£0l". The stancard MCP "E0OQJ message” is disolayed for this 
action: 


SYCOM =<job #> ECJ» TIME = 1622125521 
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When SYCOM is running in a selfmsustzining environment and it is 
necessary to shutdown the system “immediately"» then the *.STOP"” 
command provices this means for termiratione Upon entry of this 
commands atl in=process activity is aborted. A “close message” 
1s then sent to the octher SYCUM> cnly if switched Line» a 
"“disccnnect message™ sent to the Network Controtler» and the. 
progrégm goes to “end-of~job*. The system operator enters’ the 
following to initiate the immediate shutdown cf SYCOM: 


"=> <sycom job #> AX.STOP<etx> 
The fcllowing wessages are then displayed or the system ODT: 


z SYCOM =<job #> “STOP™ IN PROGRESS 
SYCOM =<job 4> ECJ» TIME = 16221:255.1 


When SYCOQM 1S running in conjuncticr with the SMCSe the “STOP* 
command entered to the SMCS tn turn causes SYCOM to be terminated 
automéstically. When this occurs» the following message will be 
displayed on the ODT: 7 


SYCOM =<job #> DEATH IN FAMILY. TIME 16:°21:°55.1 


A note of itmportance: If there are any requests queued (for 
processing» they are retained 1f SYCOM shuts down under these 
circugstancese 7 


PRINTING THE TRACE FILE 


The disk TRACE file can be printed with the *.LIST™ command. 


REACTIONARY KRINTS ANC POINTERS 


During the course of SYCOM operationss there are a few unusual 
Syste#® “conditicns”™ which could cccure In crder for the system 
operétor to correctly respond to these conditions» there must be 
sufficient information available. That infcrmation is provided 
here in the fcerm of problem descripticnss “"hints"™» "nointers”» 
and responses to these conditionse 


A. hhen SYCOM appears to be “hungtup"» enter “<job #>WY" at the 
system OCT. If the following sessage is displayed: 


SYCOM =<job #> WAITING MACAETIC TAPE <tape lLabel> 
then SYCC*® has been automatically stopped waiting for the 


required aagnetic tape te becoane available, at which time 
SYCOM operations will automatically resume. 


a 
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This. condition is resclved by the operator making, a scratch 
magnetic. tape availabte to the systems | . = i, 


Should the following message be cisplayed? 
SCS =<job #> WAITING QUEUE NOT FULL oe WRITE 


then SYCOM has been automatically stopped from “writing” any 
more messages tnto the Network Controller's input queue 
until ait can successfully deliver at least one output 
#essage@e 3 | 


If this conditicn does not resolve itself after some pericd 
cf time (€2 = 5 minutes)» the system must be brought down 
with the MCP "QC" command. CA system includes the SMCS» 
Network Controller» CANDE» and any other program associated 
With the Network Contrctler.) 


Cr if the following wessage is cispolayed», after SYCOM has 
teen just executed: | 


SYCOM =<job #> EXECUTING 


Then the problem lies in the fact SYCOM is attempting to 


establish a line connection tc ¢~ remoete system. It will 

continue in this cycle until either the cennection has been on 

established or the program DS$'d. No tnput commands’ are (e ) 

entertained durirg this initial establishment cycle. dd 
Be If SYCO™ appears to be “stuck™ during a file transfers and 

the remote system is stiit “cnline™>» then either’ the 


“ONLINE™ or “RESTART” commands fay be tried. 


1) The “QNLTNE* command wiltlk break the connection and 
attempt to renestablish remote connection. If 
successful» SYCOM will automatically start sending the 
aborted fiie again. 


2) The *"RESTART"™ comnand» with no operand» will cause the 
same -procecure te te inveked»s except that the current 
PUT QUEUE will be thrown anaye If howevers an operands 
either an imeplicit ocr relative schedule number ts 
entereds then the systew will start transmission of the 
specified file after evaluating the schedule number. 


Ce If the following message 1s cisnplayed Chy the MCP) on the 
system ODT during the initializétion phase: 


INSUFFICIENT DISK WHILE QPENING QUEUE-FILE "SYCOM"™ 


It means that there is not sufficient space on disk to open 
the "SYCCM/LINK.G™ queue. Affirmative action by the system 
operator would be to make availéeble a sufficient amount of 
cisk ‘Space Capproximately 2060 segments). | 
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TERMINAL PROCEDURES 


In this subssection»s basic termiral operating procedures are 
provided in the form cf exaaples. For a SYCOM oriented system 
however» terminalis may be owned by either SYCOM or the SMCS. 


Because of these possibilities and the. associated implications» 
specific cperating procedures are inctuded for both “"SYCOM 
controlled” ana “SMCS controlled™ terminals. 


TERMINAL FUNCTIONS 


Terminal functions are those software features found in a T[fD820» 
and/or 170830 type Video Disrlay Terminal CYCT) devices. These 
termiral features would included such things as> tab stops» 
lower/upper case» scrotling»s etces. These functtons are fully 
described in the Supervisory Message Control System (SMCS) 
Software Cperational Guide (see docurentation reference). 


TERMINAL OPERATIONS CSYCOM CONTROLLETL) 


When a Local terminal is under the direct control of SYCOM»s it is 
also permanently “attached” to tt. Therefore» a terminal user 
has ifmediate access to SYCOM functicrse <A terminal can however» 
be teporarily “attached” to either SYCOM or the SMCS in a Server 
Systeme Thru Server System"*s SMCS» the terminal can also be 
"attached™ to an appropriate interactive application oprogram in 
the Server Systeme The terminal user is not Limited to just a 
few S*¥CS commands» auser may invoke any command which the SMCS 
has in its repertoires with the excertion of those restricted to 
input from the ODT. 


Example Interective Terminal Sessior 


Termirals at this point are attached to the User Systen's SYCOM. 
In order to utilize the SYCOM capabilities» a4 terminal user need 
only enter the desired SYCOM comgands. Anong these SYCOM 
commands are “.e.CONNECT"™ and *.DISCOQNNECT"™. These are used to 
gain égccess to any appropriate interective application program in 
the ‘Server System. The exagples which fottow explore all 
possible terminal connections as cetailed in “Message Path 
Assignments”. 


In the examples below» terminal input is identified by the flag 


Hea >m, ALlt cther Lires are reoty tessages from the program to 
which the terminal is currently inputting to. First some basic 


Local SYCOM commands e2re shown. All SYCOM commands are entered 
directly as exampled below: 


“=> WHAT | , CUser SyYCOM) 
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SYCOM IXs0.2 (30 JUL 79 14: 53) ONLINE? IDLE a 
THIS STATION NOT CONNECTED | fe Age Sent 
LOCAL HOST = USER1I» REMOTE HOST = SERVERI 


--> .PUT DMPALL) a . (User SYCOM) 
FILE COMPALL START TRANSMISSION. 
“=> .WHAT a (User SYCOM) 


SYCOM IX.0.2 (30 JUL 79 14353) ONLINE; 

O FILES QUEVEDs SENDING CPMPALL €47/85) — 
TEIS STATION NOT CONNECTEC 

LOCAL HOST = USER1» REMOTE HOST = SERVERI 
FILE DMPALL END TRANSMISSION 


“=> .CONNECT | | CUser SYCOM) 


CONNECT INITIATED £029] Be bS 
CCNNECT COMPLETED to HOST = <hostname> 


==> WHAT | (User SYcoM) 


SYCOM IX.0.2 (€30 JUL 79 14253) ONLINES TOLE 
THIS STATION CONNECTED £629] Bb bB 
LOCAL HOST = USER1» REMOTE HOST = SERVERI 


--> ML3¥X oe (Server SMCS) 


MIX LIMIT=63 

SERVER/NC =<job #> PP=15, MP=15 
SMCS =<job #> PP=13» MP=14 
SERVER/SYCOM =<job #> PP=12» MP=12 
RD =<job #> PP=1i», MP=11 

END MX 


it 1s necessary that the terminal user be aware of what "signal 
character” the Server System's SMCS is currently using. To find 
out» the following commanc is enterec to query that character: 


“—-> SIGNAL CServer SMCS) 
CURRENT SIGNAL CHARACTER = $. 
Now the terminal user can “sign on™ te an application program in 
the Server Systems and alternately enter commands to the Server 
System"s SMCS. A series of followince interactions exemplify this 
concert? (CThe application program “SET/TABS™ used in the example 
1s assumed to “set™ specified tab stcps in the user's terminal.) 


--> SIGN ON SET/TABS is & (Server SMCS) 


SIGNED ON TO "SET/TABS"» SIGNAL = 
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-=—> ML > MX CServer SMCS) 
MIX LIMIT=-63 
SERVER/NC =<job #> PP=15» MP=15 
S¥CS =<job #> PP=13» sP=13 
SERVER/SSYCOM =<job #> PP=12» MP=12 
SET/TABS =<job #> PP=12» MP=12 
RCO =<job #> PP=11.» “P=11 
ENC Mx 
=> 10220230240 2502602790 | (Server AP) 
{tab stops are now set) 
REMOTE FILE CLOSED BY “"SET/TABS™. 
--> EX CMPALLSFI OUTPeFILE INV 2 (Server SMCS) 


DMPALL =<job #> BOJ. PP=S» MP=9 TIME = 11:35:21.8 
2 DMPALL =<job #> ENTER SPECS 
OMPALL =<job #> ACCEPT. 

--> <dmpall job #> AX COPY DSKLST SMCS/TRACE 


DMPALL =<job #> “QUTPUT™ = “BACKUP.PRT/905" 
OMPALL =<job #> "BACKUP.PRI/9906" RELEASED 
Z DMPALL =<job #> ENTER SFECS 
DMPALL =<job #> ACCEPT. 
“-> <dmpatl job #> AX 
DMPALL =<job #> EQJe- TIME = 11:°36:358.1 
At the point in time when a user is finished entering commands to 
SYCOM and wishes to termirate the sessions the following command 
1s entered» however» the terminal is stitl "attached” to SYCOM. 
“=> .DISCONNECT CUser SYCOM) 


STATION DISCONNECTED 


“S27 
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Terminal (per ations (SMCS Controited) 


When a terminal is permanently atteched to» and owned by» the 
SMCS» the terminal user must gain access to SYCOM functions thru 
the use of explicit SMCS commands. These commands are exampled 
below. By gaining access to SYCOM» the SMCS will temporarily 
“Wattach™ the requesting terminal tc SYCOM for the duration of a 


sessicne However» a terminal user is not liwited to just a few 
SMCS commands» a2 user may invoke any command which the SMCS has 
In tts repertoire; with the exception of those restricted to 


Input from the ODT. 


Example 1: Inter eeyave session 


The terminat at this point 1s attached to the User System's SMCS. 


In order to gain access to those rifty SYCOM capabilities» the 
terminal user must make use of the SMCS “SIGN ON" and “SIGN OFF™ 
commands. The sample session which follows» shows the terminal 


user just how easy it is to “get cn" and “get off" SYCOM: Cinput 
from the terminal is identified by the flag "-7>".) 


--> SIGN ON SYCOM (User SMCS). 
SIGNED CN TO "SYCOM™» SIGNAL = * 
When the “signed~on™ message is returred to the terminals» that 
termiral is then attached to SYCQM. Therefore» SYCO™M commands 
are ertered directly as exanrpled belcw: | | 
“=> WHAT (User SYCOM) 
SYCOM IX.0.22 €30 JUL 79 14253) ONLINES IDLE 
THIS STATION NOT CONNECTED 
LOCAL HOST = USER1» REMOTE HOST = SERVERL 
“-> PUT DOMPALL | CUser SYCOM) 
FILE DMPALL START TRANSMISSION 
7“-> WHAT CUser SYCOM) 
SYCOM IXe0-2 €30 JUL 79 14253) GNLINES 
O FILES QUEVEDs SENDING CRPPALL €47/85) 
TRIS STATION NOT CONNECTED 
LOCAL HOST = USER1s REMOTE HOST = SERVERI 
FILE DMPALL END TRANSMISSION 
“-> .CONNECT CUser SYCOM) 


CONNECT INITIATED (£0281 Aa aad 
CONNECT COMPLETED to HOST = <hostname> 
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“-> .HHAT CUser SYCOM) 


SYCOM IX.0-2 €30 JUL 79 14253) ONLINES IDLE 
THIS STATION CONNECTED £C€28@] Aa aA 
LCCAL HOST = USER1» REMOTE HOST = SERVERI 


--> #*REPCRT > CUser SMCS) 


>R1 COOT)= ON JOB #15 SYCOM 
1 STATION REPORTED AT 113242 08/22/79 


--> WML>PX (Server SMCS) 


MIX LIMIT=63 

SERVER/NC =<job #> PP=1S» MP=15 
S¥CS =<job #> PP=13» MP=14 
SERVER/SYCOM =<job #> PP=12» MP=12 
RO =<job #> PP=1i» MP=11 

END MX | 


It is necessary that the SMCS in a Server System have a “signal 
character” thet is aifferent than that of the SMCS in the User 
system. To ensure thise the foltlcring command is entered to 
query that signal character: CIf it "is not” differents» then 
change itz “SIGNAL $".) 


“-> SIGNAL | CServer SMCS) 
CURRENT SIGNAL CHARACTER = $ 


Now the termiral user can “sign or™ to an application program in 
the Server System, and atternately enter comsmands to the Server 
System's SMCS. A series of following interactions exemplify this 
concert: (CThe application prograse “SET/TABS”™ used in the example 
1S assumed to “set™ specified tab stcps tn the user's terminat.) 


-“-> SIGN ON SET/TABS CServer SMCS) 
SIGNED ON TO *SET/TABS*» SIGNAL = $ 
--> $ML>%-MX (Server SMCS) 


MIX LIMIT=63 

SERVER/NC =<job #> PP=15» MP=15 
SMCS =<job #> PP=13»5 MP=13 
SERVER/SYCOM =<job #> PP=12» MP=12 
RC =<job #> PP=1l> MP=11 

SET/TABS =<job #> PP=4> MP=4 


END MX 
“=> *REPORT > (User SMCS) 
>R1 (ODT): ON JOB #15 SYCOM 


1 STATION REPORTED AT 11244 OQ8/22/79 
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==> 10520%3C»40%50260970 - «(Server AP) 


(tab stops are now set) 
REMOTE FILE CLOSED BY “SET/TABS". 


--> ,DEBUG (User SYCOM) 
DEBUG OFF 
==> .DISCONNECT | (User SYCOM 


STATION DISCONNECTED 
At the point in time when a user is finished entering commands to 
SYCOM and wishes to terminate the sessions the following command 
is entered: (This is a SMCS command.) 
“-> «SIGN OFF CUser SMCS) 
The response from the SMCS will be as follows: 


SIGNED OFF “SYCOM*™ 


At this point» the terminal has been “detached” from SYCOM and is 
now “resattached”™ to the SMCS. 


Exasole 2: Irteractive Session» Sysitew strings 


This example of a typical interactive session whereby the user on 
one system communicates thrcugh several other systems In a string 
of systems to direct the ena system ir specific functions. To do 
this» example 2 utilizes the SMCS "PASS" command exclustvely. [t 
provides the means to establish ccrmunication Links to an end 
system without having to “signwon"™ tc each system in the Link. 


At this pcint the terminal is attached to the User System's SMC5. 
In order to géin access to the SYCOM system~string capabilities» 
the terminal user can either make use of the SMCS'*s "SIGN ON™ and 
"SIGN OFF™ commands cr the “PASS™ ccauwande For this examples the 
PASS command will be utilized. 


For this example of accessing systenrv~strings» the distributed 
System complex we all know as the HUB/Slave systems was chosen. 
Therefore» each step of the follcwing procedure can be compared 
against the string system schematic cn the following page. With 
this combination» a user can goa as far into the system=strings as 
desired. | | 


In the following orocedures» exanple terminal input is shown in 
“Lower case"*s upper or lower case is allowable. Terminal input 
is aiso flagged with the "~-->" reference identifier. 
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we will begin ty Loggington to the user*s SMCS. This establishes 


a base connection» however» it is not a requirement. 


==>. 10° "sycon dser” “Sets S$s32="seese ===" > (SMCS sys 1) 


B1800/81700 SMCS MARK IXe0.00D (08/20/79 13240) 


"“sycom user” LOGGED ON *SMCS~- AT C846 08/30/79 
YCU ARE AT STATION 21 CTCE&I2) 


If "US A/B™ is ertered then user A with password B is togged on 
to the local SMCS. Alt subseauent PASSes to SYCOM wilt 
automatically inctude this userccde/password pair» Thus» 1f the 
user is dectared to be a workstations file security is enforced. 


When the “*loagged~on™ message is returned to the terminal» that 
termiral ts then attached te the SMCS. Hereafter» SYCOM commands 


are entered via a series of *“PASS" gsessages as follows: 


“=> p sycom econnect “ttt ttt tet ttt menm> CSYCOMs sys 1), 


CONNECT INITIATED ©0281] Aa aad 
CONNECT COMPLETED 


"=> p sycom eSignal Loo weertrrs= Sree ey aes > CSYCOMs sys 1) 


STATION SIGNAL IS "1" 


“<> D sycom iwhat 2296 3s eo a a ae a oa ca > CSYCOM; sys i) 


SYCOM I1X.0.2 €30 JUL 79 14253) ONLINES 1 FILE QUEUEDS 
SENDING: (€7901/15325)3 

THIS STATION CONNECTED (£028) Aa aA 

LOCAL HOST = SL2» REMOTE HOST = HUB 


Cne will not see filenames since it is a usercoded files» unless 
Legged on the SMCS as usre CJHJ- CSee adove) 


==>: ). GYCOM SYStES “10. “Ser Kes 2seSe= == =s> “-> (CSMCSs sys 2) 
SYSTEM@ID: THE.HUB 
PERLERELCCRECECEEELELCECEELCCEEEELECELCEPERELCCCECLLECCCCT | ARUN HANRHKRRH Mw 
Current terminal PASS message paths: 


be | 
. x 
VDT input ttt 3tOt> <xx> 2 2 © © © © =» @ © © © © » SMCS sys 1 & 
j---> p sycom 1<xx> «« «© «© «© @ «© © « SYCOM sys 1 #8 

| 

Ee | 


Rak H & 


> lee ¢ Pp SycOoOmMm <XX> so © © 0©« 8&® 8® @ »® SMCS sys C3 
HRMURNHANUNARHNUARHKNANRNHN REMAN HHNHUNAANMBARANRNKCUN RAMANA AHNARKNNRNAAMNNAMAM URN me 
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=e 0 °SYCCOS Slr ak SS oer S Sets Sse ee > (SMCS? sys 2) 


MIX LIMIT=63 

HUB/NC.JUL26 =<job #> PP=15» MP=15 
SMCS =<job #> PP=13» MP=14 
CUSERL)/SYCOM =<jobd #> PP=12» MP=12 
CUSER3)/SYCOM =<job #> PP=12» MP=12 
END MX 


At this points» as shown in the messace path block above» the user 


has established a communication Link to a second system. Input 
can be sent the SMCS» MCPe» or SYCOM in either of the two systemse 


if a connection 1s desired to a thire systems then continue with 
be entering the following command: 


“=> Dp SyCOG. p Users «connect  ==<<--=s=---= > CSYCOMs sys 2) 


CONNECT INITIATED €0311] Aa ad 
CONNECT COMPLETED to FOST = <hostrame> 


""> p sycom p user3 esignal 2 sewer errnnnn-> CSYCOMs sys 2) 

STATION SIGNAL Ls, "2° 
(— "="-> p sycom p user3 2what "3" -%-- SSS 25> > CSYCOMs sys 2) 

CUSERZI/SYCOM IX.0.3 €C@ ALG 79 15219) ONLINEs IDLE. 
THIS STATION CONNECTED (0211 Aa aA 
LOCAL HOST = HUB» REMOTE HOST = SLAVE3 

--> p sycom p user3 systen Tee tsttrsrsss-- > CSMCS> sys 3) 
SYSTEM"ID: SLAVE3 


SYSTEM@TRANSLATE=: ON 
SYSTEM@VERSTION: B1@00/81700 SMCS MARK IX.0-09D 


RUAMNMHHAMNRUANKNRMAUNRNRUAKMHENMMNRHUNRNRHRNOCKHHUMNHBKHNRHNMHRNNMHHURNMHMKRHNMnHMN MMH ois 
Current terminal PASS message faths: 


P| 

yw 

a VDT input —mawmmm=s> <€XX> © 2@ © © © 2 2 © © 2 8 2 @ SMCS sys 
a Im--> p sycom 1<xx> «© « «© © © «© © »& SYCOM sys 
a Ilen-"-"> po sycom <xx> «© © @ = © «© »@ »« SMCS sys 
nm 
bs! 
| 


NOR Me pee 


l--"> p sycoa p user3 2<xx> « « «© #« SYCOM sys 
| Im-""-> p sycom p user3S <xx> 2 «© © « SMCS sys 3 
HHARARHAARHANMARAHRNHRAKRMNRHAKNMARRHHANHARDAKHHRHANHANRAKRCNRHRANNKNRARNHRNRANHMMRNnKMKRHoR 


RRRRAR AR 


The user how has accesses via SYCOM ccnnections» to a third system 
in the string of systems>, as pictured in the message path block 
above. If it is desirable to extend these connections to a forth 
System» then enter the following command string: 
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"> p sycom p Bere <e. sal -conrect mamocwmnm> CSYCOMs sys 3) 


CONNECT INITIATED CO36] fa ad 4 
CONNECT COMPLETED to HOST = eilesenanes 


“-> p sycom p user3 p sal .sigqratlt 30 teees=> CSYCOMS sys 3) 
STATION SIGNAL IS *™3" 

“=> p sycom p user3 p sal Swhat swttterett> CSYCOMs sys 3) 
SA1 IX.0.3 €O8 AUG 79 15219) ONLINES ‘IDLE. 


THIS STATION CONNECTED [036] Aa aA 
LCCAL HOST = SLAVE3» REMCTE HOST = SA! 


HHRMA HRHANRNHHHMARNRAUANRRKHHNKANHMANHRAMAUNNMHNHAKDHANNRKRNHHKNNAKRHAAMHHANMNNMRNRNNMHKNMnHnWR 


Current terminal PASS message paths: xn 
P| Pes 
a VOT Input ee, Ta > SXX> « © 2 2 2» © © 2.0 2 2 @ - SMCS sys 1 4m 
am pers >. fp sycom 1<xx> > 2s = = 8 & 8 ® SYCOM Sys 1 ox 
u Ie7-"-> p sycom <xx> « »« «© # « « # « SMCS sys 2 & 
o | I---> p syco@ p user3 2<xx> « e« e « SYCOM sys 2 2 
m I-""-> p sycom p user3S <xx> «© © » & SMCS sys 3 8 
x Ie--> p syco@ op user3 ¢ sal 3<xx> .« SYCOM sys 3 8 
| j---> p sycoa p user3 f¢ sal <xx> «.« SMCS sys 4 m 
Pos is hs Bs se ee ee ee ee Es ies es ee eR eB Bs Bo i ee Be Be ss Be Bre ER se Be Bt os Be | 


At this point» the user has connections all the way thru to the 
oMCS in system “SAI. Commands car te giver to the SMCS or MCP 
in that system or any system atong the way in the message path 
connections. 


“=> p sycom p user3 p sal system =e terre > C(SMCS> sys 4) 
SYSTEM-I03 SAl1 
SYSTEM*“TRANSLATE: ON 
SYSTEM“VERSION: B1800/81700 SMCS MARK IX.0.00D 


--> p sycom p user3 p sal aloarx ~---------- > CSMCSs sys 4) 


MIX LIMIT=63 

SA1/NC =<job #> PP=15» MP=15 

SMCS =<job #> PP=1l4» MP=14 
CUSER3)/SYCOM =<job #> PP=13» MP=13 
CANDE =<job #> PP=13» MP=13 

RD =<job #> PP=13» MP=12 

END MX 


With the current interwsystem connections» a terminal user can 
"sign- on™ to programs in either cf tte four. vee and/or Issue 
SMCS end MCP commands tn these systems. 
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In the following example» a compile is initiated in the forth 
syste@s» without usercode security being enforced: 


“=> p sycom p user3 p sal co ¢x sdlsfi cards nam xs dsks> 


PX =<job #> BOJe PP=4» MP=4 TIME = 09200:220.6 
PX =<job #> EQJ- TIME = €9:302208.8 


After ali transactions with the SAl system have teen completed» 
atl connects must be "disccnnected". This must be accomplished 
with the fotlowing command procedure: (C(8y giving a *"bye™ command 
to each SYCOMs the “station signal character"™ its restored to "." 
and the virtual station 1s automaticatly “disconnected”. ) 


--> p sycom p user3 p sal S3btye sweeter tersr="> (CSYCOMs sys 3) 


STATION DISCONNECTED 
USER SY LOGGED OFF TO SA1 AT 09:201321.3 ON 30 AUG 79 


“=> p sycom p user3 2bhye  wtetserreerteterr=> CSYCOMs sys 2) 


STATION DISCONNECTED 
USER SY LCGGED OFF TO CUSER3SD/SYCOM AT 09202244.1 ON 


==> ‘D.sycom Loye “See srerSse$ +6 sSeeees——=> (CSI COM: sys. 19 


STATION DISCONNECTED 
USER SY LOGGED OFF TO SYCQM AT ©9:03238.1 ON 30 AUG 7 


“=> PDP SYCOM What “<<se8eos eso essee—ere==—> CSYCOM? sys 13 


SYCOM IX.0-2 €30 JUL 79 14:53) ONLINE? IDLE 
TRIS STATION NOT CONNECTED 
LOCAL HOST = SL2» REMOTE FKOST = HUB 


At this point» control of the terminal has reverted to the SMCS. 
Example 3: Interactive Session» System Strings 


This ts other example of a typical irteractive session when the 
user on a local system communicates through several other systems 
In &@ “string cf systems” to direct ar “end systean”™ to perform a 
series of specific furctionss of the user's discretion. 


In this examples use of the SMCS “SIEN ON" command is utilized to 
provide the means to establish the ccrmunication Links to an “end 
system"s Signingmon"™ to each system in the Linke By doing this» 
aouser 1s assured that tasks can he cirected to “any” system in 
the string and have the appropriate security apptied as needed. 


At this point the terminal ts attaeched to the User System's SMCS. 
In order to gain access to the SYCOM systemn-string capabilities» 
the terminal user will make use of the SMCS*s “SIGN ON” command. 
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For this example cf accessing system=strings» the distributed 
system complex we all know as the HUE/Stave systems was chosen. 


Therefore» each step of the followirg procedure can be compared 
against the strinow~system schematic (CFigure V~1). With this 
combirations a user can go as far into the system=strings as 
desired. ~~. 7 ~ 


In the following procedure» exaaple terminal input is shown in 
"Lower case™ Cupper or tower case is attowable). Terminal tnput 
is also flagged with the “"~>" reference identifier. | : 


Refer to Figure V71 for the string system message path schematic. 


The user begins by “Loggingwon”™ to the local SMCS. This usercode 
and péssword wilt be used by both SYCOM and SMCS to automaticatily 
log the user on to each system in the Link CSYCOM/SMCS)> 


--> us sy/user -999e+-"--- oo n2------------- > (SMCS? sys 1) 


B1800/B1700 SMCS MARK IxX.0.00D (08/20/79 13240) 
CSY) LOGGED ON “SMCS~= AT 09213 Q8&/30/79 
YOU ARE AT STATION 1 C1D8S52) 


The terminal is still attached to the SMCS in system 1. To make 
an attachment to SYCOMs enter the follcwing “SIGN ON® command: 


“=> on sycom Ss Se=62Se= = a aewenn ene ee >. LIM CoP Sys 12 


SIGNEC ON TO “"SYCOM"» STIENAL = * 
B1790/B81800 SYCOM I[xX.0.2 €30 JUL 79 143253) 
USER SY LOGGED ON TO SYCCM AT 092132338.1 ON 30 AUG 79 
72>> BHOKE Sigcal J Sse eee sees seers === ==> CSMCS> sys 1) 
STATION <name> SIGNAL CHANGED TO a 
“32 sGongect “Sse == Se eS ee eee en > CSYCOMs sys 1) 
CONNECT INITIATED £028] fa aa 
CONNECT COMPLETED to HOST = <hostname> 
BLéE00/B1i700 SMCS MARK IX.0.00D €08/20/79 13240) 
CSY¥) LOGGED ON =SMCS— AT 09215 08/30/79 
YOU ARE AT STATION 21 CVIRTUAL) 
72" @sSiGnd..:) =r ssSSn es SSeerrS ete ens > COTCONs: Sys 22 
STATION SIGNAL IS "1" 
“=> 20a Sees tes SSeS iat Se > CSYCOMs sys 1) 


SYCOM IX.0e2 (30 JUL 79 14253) ONLINES IDLE 
THIS STATION CONNECTED €0281 Aa aA 
= - USERCCDE = SY» LOCAL KOST = SL2» REMOTE HOST = FUB- 


- 7-16 © 
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Either one of the following mayte used in place of the above 
staterents. | 


ON SYCCM CONNECT 


or 
ON SYCCM. SIGNAL 1 
1CONNECT 

BRANMNUNANMRMWHONRMRMRMARNWHMHNMRNHNHKMMNUMNNUHKRHMnHn nA TO EE SS EE Te OT ge ed Ska 
nt Current terminal tinoput messace path assignments H 
pe | Be | 
m VO Anout: =sSesess2s=s> > @<xx> «© 2@ e SMCS sys 1 i 
u [sss -ss= > 1<xx> | « ee SYCOM sys 1 | 
a § | ee ee ee ee > <xxX> os 2. « SMCS sys 2 m 
HABANA DAHMHARHNEORNHANMMNNMKNHNMRUMRNKANRHHRAR HH HHH AKHMNNUNNRMRHMMN MMMM NRW oY 

-“-> system 777° re Seeger ene eee eae ee para eee ne > (SMCS? sys 2) 

SYSTEMIC: THE~HUB 


SYSTEM@TRANSLATES ON 
SYSTEM“VERSION: Bi8CO/E17900 SMCS MARK IX.0.00D 


Now the terminal user can establish a connection to any other of 
the systems ir the string. At this pcint we can make connection 
to the third system Cslave 3) by entering the following command? 


Sa> 00 USe6r Ss “<ssees seo =e= Sass SS SS = meerewm=> CSMCS> sys 2) 


SIGNED CN TO "SYCOM"» SIGNAL = <2> 
B1700/81800 SYCCM IX.0.27 (C08 AUG 79 15219) 
USER SY LOGGED ON 10 CUSER3)J/SYCOM AT 09216244.1 ON 


It 1s necessary for the SMCS*"s "signal character™ in Systen-2 be 
different than that of the SMCS in ttre Systenc-l. If the “SIGNED 
CN TC “SYCOM"" message returned for the last signmon 14s. other 
than ¢ “d"» then skigc the next input commands otherwiser change 
the "SMCS's signal character” in System~2 as follows: 


"=> <current signal> make sigrél $8 we""%""" > CSMCSs sys 2) 
STATION <name> SIGNAL CHANGED TO $ 

“ei SCONNGCh Sf SSs pS ses r="s2°=.-- <2 > CSYCOMs sys 2) 
CONNECT INITIATED £931] Aa aad 
CONNECT COMPLETED to HOST = <hostname> 
Bia@00/B1700 SMCS MARK IX.0.00D €08/20/79 13:40) 
CSY¥) LOGGED ON “SMCS~- AT 092517 08/30/79 
YCU ARE AT STATION 41 CVIRTUAL) 

reo BSIONAl << STSsS Senses Re 2s sles Se > CSYCOMs sys 2) 


STATION SIGNAL IS "2" 


EI es BAe en x Binh hit ak 


a a aR Sa a aa BS aS ade a AR aT | Rs MC CIE 
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eee 2 eee eee eee eee eee ee eee ee eee ee eet se eee ste te s-6 6 2:6-6- 2°56 -6-6° 8 


am Current terminal input message path assignments x 
n | . nu 
M VOTE ANDUL. SSF eee ene == > a@<xx> »« 2© © SMCS sys 1 n 
am . j-- ey pe eee > 1<xx> 2 2 @e® SYCOM Sys 1 | m 
P| (esse > $<xx> 2 2 @ SMCS sys 2 uw 
H fesess=ss > 2€xx> « « e« SYCOM sys 2 m 
u | | Paes Sea > <xxKX> » 2» » SMCS sys 3 b> 
RUAMNMAKRKARHAHHRHHHRHMNANNRAARHUMAKRNHHHRRHRHRHNAAHDKHHNHHMAHKRHHRHANRHKANMMHMRHRANRMHn HW 

“=> system —- ow = an oe a ta Oe ee ee ee om oe ee a —— tf - £ Yet > CSMCS> sys 3) 

SYSTEM-ID: SLAVE3 


SYSTEM“TRANSLATES ON 
SYSTEM@VERSIONS B1800/E1700 SMCS MARK IX.0.00D 


“=> on sgl cto teow eee ne cnn a== eee ewese= menrm=> (SMCS> sys 3) 


SIGNED ON TO “SYCOM*» STENAL = 2 
Bi700/818CO SYCOM IX%.~C.7 (08 AUG 79 153519) 
USER SY LOGGED CN TO SAI AT 09218259.3 ON 30 AUG 79 


It is necessary for the SMCS"s “signal character™ in System-3 be 
different than those for system's 1 arc 2. If the "SIGNED ON TO 
"SYCC¥"" message returnec for the lest signmon is other than a 
"a" or "$"» then skip the next Input commandr otherwiser change 
the “SMCS*ts station signal character® in System"3 as follows: 


“=> <current signal> make signal # wwtwtrewnw=> CSMCSs sys 3) 
STATION <name> SIGNAL CHANGED T0 2# 

==> «»s€Onnect =S"===<ss i a a a w—=> CSYCOM> sys 3) 
CONNECT INITIATED [£028] fa aA 
CONNECT COMPLETED 7 
B1800/81700 SMCS MARK IX.C.00D (08/20/79 13240) 
CSY¥>) LOGGED ON *SMCS~= AT C9220 08/30/79 
YOU ARE AT STATION 41 CVIRTUAL)D 

“=> eSignal 3 eset mt ews ern eee en ene en- aaa > CSYCOM$ sys 3) 
STATION SIGNAL IS *3" 


At this points the user is now connected to» and logged~ons the 
SMCS tn the “SAI1™ systen. 
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CeCe Ee TELE ee TS CEE. EE Cee t Sl Sete ete bast: 2-6-0. t-te: t-t::6-t:2'S: 1: O:)-t 80° 00-8.) 


Current terminal input message path assignments u 

a pe | 
a VO ANDUL-. ==2Se+eoe="e7""= > a<xx> 7. 2 @ SMCS sys l nm 
m (S242 22> > 1<xx> «© © ee SYCOM sys 1 | 
| (s=s+s--- > %$$<xx> - » SMCS sys 2 " 
n i=s2sSs= > 2€xx> «- «© » SYCOM sys 2 i 
a a2 ee < > #<xx> 7. 2 © OMCS sys 3 a 
n [233s ==>2> 3€xx> - 2 ® SYCOM sys 3 m 
a [<S=-e3=% > <xx> »2© » «© SMCS sys & nt 
AUDHOUATPHUAHUANNMMNMNMMUANRMHNUAKRHNANMARHHMHRHAUNAKAUAANMANMNUAMAHHARHNRHANMMARANAHAHKANK 
o“> GYStER: SP PSS es SSeS es SSeS mw=> CSMCSs sys 4) 


SYSTEM-ID: SA1 

SYSTEMmTRANSLATE? ON 

SYSTEM~VEFRSIONS B18CO/E1700 SMCS MARK IX.0.00D 
The connections exist to allow input messages from your terminal 
to be sent to the SMCS in the *SA1™ system. At this points one 
is free to “PASS” to progragss in that syste and/or give commands 
to the SMCS/MCP theres: 

“-> co px sdilsfi cards ram Csy)/xs dsksx w=-> CSMCS> sys 4&4) 


CSY) PX =<job #> BOJ. PP=4» MP=4 TIME = 09211:217.6 
CSY¥) PX =<job #> EQJ- TIVE = 09212259.8 


“<=> «os System id ““=<s=<+==+=- Soe 6 oon eas sees > CSMCS> sys 1) 
SYSTEM“ID: SL2 

“=> $$ system id setts ster esses seen nce nacen > CSMCSs sys 2) 
SYSTEM=ID0: THE.HUB 

=“3> 2 6ystem 3d “Stet ese sess sos esse5 eo 4sSe= > CSMCSs sys 3) 
SYSTEM“ID2 SL3 

“=> 1 what semesters ses eS ee eee swe sees cece > CSYCOMs sys 1) 
SYCOM IXe0-2 (30 JUL 79 14253) ONLINE? IDLE 


TRIS STATION CONNECTED £C281 Aa af | 
USERCCDE = S¥» LOCAL HOST = SL2» REMOTE HOST = FUB 


"=> 2 what wet eee wenn nn== weoee se eewoeee a diedieatentans > CSYCOMs sys 2). 


CUSERSI/SYCOM 1X%.9.3 C08 ALG 79 152319) ONLINEs IDLE. 
THIS STATION CONNECTED [C411 Aa aA 
USERCCDE = S¥» LOCAL FOST = HUB» REMOTE HOST = SLAVES 


a> 3 what Bee ABs Bn asawtwanaannsawasane eee eg pee ee ee por > CSYCOM>,; sys 3) 


i Maen Ne ve latees ae Nicene inionione 
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SA1 1X.0-3 C08 AUG 79 15219) ONLINES IDLE.~ 
THIS STATION CONNECTED [0401 Aa aA 
USERCODE = SY» LOCAL FOST = SL3»> REMOTE HOST = SAL. 
“=> ex dmpallsfi outpefile iny 23pr 113 
CSY) DMPALL =<job #> BOJ. PP=11» MP=11 TIME = 09:22:21 
2 CMPALL =<job #> ENTER SPECS. 
CSY) CMPALL =<job #> ACCEPT. 
“=> <job #>AX COPY DSKLST SMCS/TRACES 


% DMPALL =<job #> ENTER SPECS. 
(SY) DMPALL =<job #> ACCEPT. 


“=> <job #>AX 
CSY) CMPALL =<job #> EQJ. 09223211.2 
After all transactions with the SAl system have been completed» 


all connects must be “disconnected". #£=17This can be accomplished 
with the following List of commands: CAgain» by giving a *bye" 


command to each SYCOM in the chains the “station signal. 


character™ is restced to "."” arc the virtual station 1s 
automatically “disconnected”™.) 


“=> Shye seoeeennnen--------- 2 enna n= ----> CSYCOMS sys 3) 
«STATION DISCONNECTED 


USER CSY) LOGGED OFF SA1 aA O93233 3301 ON 30 AUG 79 
DETACHED FROM "SA1" 


e=> 2bye -orereon-------- mt ee nnn nnn nnn > CSYCOMF sys 2). 


STATICN DISCONNECTED 
USER CSY) LOGGED OFF CUSERJI/SYCOM AT 09% 33° 23.2f ON 
DETACHED FROM “USER3™ 


“-> Adisconnect  tt7777 37777 atekahaieteiatebetahaiete => CSYCOMS sys 1) 
STATION DISCONNECTED 
“=> what wt ets tt rrr sete t seen enn- woemm--> CSYCOMs sys 1) 
SYCOM IX.0.2 (30 JUL 79 14253) ONLINES IDLE 
THIS STATION NOT CONNECTED | 
USERCCDE = SY» LOCAL HOST = SL2» REMOTE HOST = HUB 


“-> bye co9---- wana na nnn nn nn nnn n-> (SMCS3 sys 1) 


CSY) LOGGED OFF SYCOM AT 09224:09.1 ON 30 AUG 79 
DETACHED FROM “SYCOM™ 


EE ee ren eT Ne wien ae meee, 


‘Witte el aides thom ee acustesticiee wate alias ged meet i naa tas ee a lati Sata ala ana atl EE aa al geen ahd ee dei ltt teal 
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At this points control of the termirel has reverted to the SMCS. 


The *O0FF command may be used trstead of the above List of 
disconnect commands. The *OFF will discornect one completely 
where as the above disccnnect ccamtands must be done one input 
message at a time. 


ced iri asi eelmecisestheninincdnibae’ 
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GENERATING NETWORK CONTROLLERS 


GENERAL | 


This section is provided as a user oriented guideline to the 
generation of a Network Controller for the SYCOM system. The 
contrctiler is cenerated by the Network Definition Language CNDL) 
compiler usina a prepared set of NADL specifications. The system 
user 1s required to determine these ADL specifications according 
to the system configuration and ervironwent under which the 
Network Controller is to function. 


The fcllowing guidelines are cffered fcr a target system that is 
to provide the full range of SYCOM services including terminals. 
They <re intended tc aid the user In generating a Network 
Contretler with correct functional attributes. For a complete 
description of the NDL specifications and definitions»s refer to 
the “Network Definition Language reference manuat™ Cassociated 
documentation). 


DETERMINING THE SPECIFICATIONS 


The fetlLowing sample Network Controitler NOL specifications are 
presented in a sequence similar to that of the NOL reference . 
manual. This allows the user a logical reference for evaluating 
the sample NDL specifications for aprlication to the installation 
requirements. They identify suggested parameters which oproduce 
an cperational Network Centrotiler program for the SYCOM system 
configuration as specified. 


GPERATIONAL PROCEDURES 


The fcllowing procedures provide the methods by which the user 
prepares the input to the NDL compilation process» generates a 
Network Contrctler» and induces wsodifications into the resident 
NDL ccmpilers if required. 


PREPARATION OF INPUT 


The NDL “source™ input file can be prepared ir the form of either 
acarc file or a NDL type disk file. The disk file could be 
created and maintained using CANDE or another text editor of 
similar capabilities. | | 


The “Sample NCL Parameters File” is furnished for the purpose of 
creating this file with the most. atcunt of accuracy in the least 
amount of time. Any adjustments te this scurce file for number 
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o f lines» terminals» and other such attributes is the 


resrorsibility of the user which is attuned to the system 
configuration and its cperational environment. 


COMPILATICN PROCESS 


Prior to initiating the NDL compitaticn process» the user should 
ensure the presence of a *1020 NOL/LIBRARY™ file on disks of a 25 
Oct 1580 or tater vintage). Then» there are severat methods by 
which the NDL compilation Cgenerative) process can be invoked. 
Following are two of these rethods: | 


Card Input: 

Following 1S a primitive example of a NOL source card input 
deck: (CThe <I> in the exanople telow represents an “invalid” 
character as required by the MCP.) 


<I> CO USER/NC NCL LI 
<I> DATA CARDS 


NDL source images 
AOL Library catts 


<I> END 


Disk Input; 

This method 1s used to initiate aNDL compiler process when 
the source irput file resides cr cisk» Enter the fottowing 
YCP command using the system ODT: 


CO USER/NC NEL LIisFI CARDS NAM USERNC/SOURCE DSK DEF 


From this point on» the compilation procedures are the same-. 
When the MCP executes the NDL comoilers» a normwat "“BOJ" message is 
displéyed- Upon successful compteticn of the compiles the normal 
"E0J" message is displayed. However» if an error message such as 
the cre below is displayed: 


NDL = USER/NC =<job #> --EVALUATICN/PROGRAM POINTER STACK 
OVERFLCW DS OR CP 


Then the “NDL Compiler™ must be mccified to increase its “name/ 
value stack™ sizee 


PRINT THE USER/NCNIF FILE 


Once the compilation/generation cf the Network Contrectler is 
comptete» it 18 Suggested that the “Network Information File” be 
printed. This 3s accomplished Ey executing the following 
progréems and providing the correct file name Cif different than 
the cone suggested): 


beeen) lap rn ac tr Bae Stee A 2a Spins ids Bi ES aa ee ite Si Ss my PS CH 9 I Ca i pea ag ee ee, ae ee ae Ro er Oe ae a TOON eT ETS ITT Ue STCETS Tae Se OOO a a Se a UO 
ec PAE EE LEA TL ISLE Eee aa eh tere a « = ~ seen: 7 —— arias rae nn 
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“EX NIF/ANALYZERS FI NIF NAM USER/SNCNIF<etx> 
: | Pes 
NIF/ANALYZER =<job #> BOJ. PR=4 TIME = 1120522721 
NIF/ANALYZER =<job #> EQJ. TIME = 11207212.9 
SAMPLE NDL SOURCE FILE CLOCAL USER SYSTEM) 


Following is a sampte NDL source file to be used as input to the 
NOL compiter for the generation of < Network Controtler oriented 


to a Lser System. This example prevides a Network Controller 
which services a locat site of 3 terminals» 2 virtual terminals» 
and a interwmsystem connecticne The user must tatlor this sample 


Network Contreoctter specifications te the needs and desires of the 
installation Ceege» more/less Local terminals» more/tless virtual 
termirals» etc). 


This sample ADL tnput file is comprised of both NDL statements 
and pérameter specifications. The resulting Network Controttler 
will provide the correct functional attributes necessary for the 
operation of the SYCOM system? in testing modee 


$ CONTROL 

$ LIBINFO 

$ NSSIZE 20 Z nunater of ertriess for IOLOG 

$ VSSIZE 15000C 2 nusgber of bits», for IOLOG 
y ae May Say Lie Sy iy My Ay Soy ap 5 a Sy Say ay Sa Sy ip Ay ip Snr Si: ay aye Aa Sp Mia Ale Sage Ml Wr a Sa tr ir Ai sae Sy Le ay Ae Ae Aaya le Say lr a ae My A ya ir Ay 
y4 2, y4 
y 4 Declaration Section Z 
y4 z 
y Say ay Gy Sy ir Say iy ey Sir Sie iy Mi Lip Say Se Sa Sy ae iy a Sy So Si Lar iy Aa ae iy ay Sp iy Sy Ae Lay ip Shy Aa ay Sa ay Say yay fay ae iy Aly Say Ar ay Ay dy Aa Sip Sr ae Ma Say A 

DECLARATION: | 
NIF = "USERS/S°NCNIF"™. % NIF file name> user option 


MAX FILES = 16. 

MAX BUFFERS = 2. 

MAX MESSAGES = 20. 
$ LIBRARY SYCCMDEC 


RRRRARERARUR ARAL ER RAE hehe en hhhhhhhahahhahinatahhtaeinhhhhhhhhhite 


v4 7 | rs 
Z Requests and Cortrols | | % 
ri yA 


Rh ahhh hehehehe hh hhh hich ahhh hhmuhhhhioh hhh teh hte tah fe letet heheheh 


$ LIERARY SYCOMREG 

$ LIBRARY CANDEPOLTD Lex 
$ LIBRARY CANCEFSLTO Lae 
$ LIBRARY SYCOMCTL 

$ LIBRARY CANDETDCTL Lee 
$ LIBRARY SYCOMREG © 


saueld Ui petg Sere tape ees eae ie Sots Fa dan abe cette eh toc 3 sets art adam ti ie tee | ae tin tale op aly wae tt ber teats sg Seaste tone te tetbe st Nesioe sfattete db dtte TP seardh ene inty ada gieeee wh analy lane baste gale Barong hemaalbn Ra OR SS ee) Reed “aptel, “Terthd Yab aed joe le arial Sia eee oe Bel Si Mia 
oat is ih aia ts seis man Se Sib Lad abot Mla NS LS alls SES oo, AGH ala aire steer. Tost ba arbiois in thle ithe iio oct GTS silat ot oS SS Ste oS Sen ES SE ea ay Sot Sa a ee a ee ch nel Sot i Fa i, Slee al Rae, DO RRO AE GLE Reed yy We ee ys Bl is WP ia 
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Khhhhh ahah hihhhhhhhhhhhhihahmaahhnahhhhhhetihhhishhhhh hhh 


4 pA 
y4 Network Configuration % 
4 vA 


KALLRARLAAALATAN ALA hhh la hh te eee hia ea ahah hia hte ee hoa heehee lanta ta he ta ho oho ato no a an 


ARaRR aaah ahhh hhh hhh hhh hhhheanhaahbmhnbahrhbeahhremhhiah 


yA Z 
x Terminal Sectior yA 
Zz Zz 


RRRERARARRD ZARA aaah ahh hhhdbhhhhhhhbhhhhh he hbhhhhhhhhhhh 


TERMINAL DEFAULT SYCOMDEFAULT: 
REGLEST = SYCOMREQSRECEIVE» SYCOMRECZIRANSMIT. 
TRANSMISSIGA = 1. 


ADDRESS = 2. % Number cf polling address characters 
BUFFERSIZE = 3840. Z% 2x 1920 bytes 
TYPE = 62-6 % B180c 


TERMINAL SYCOMTERMINALS 
DEFAULT = SYCOMDEFAULT. 


TERMINAL CEFAULT YDFLT: Ax 
REQUEST = CANDEPOLTD:RECEIVE> %*« 
CANDEFSLTOS TRANSMIT.Z*%* 


TRANSMISSION = O- Zz 
ACDFESS = 2. Zk 
TYPE = 44. Zxx YFC820 
BUFFERSIZE = 2250. Xx 
TERMINAL TD3243 Lx 
DEFAULT = TOFLT.- ZZ xe 
RM nmhhhhhhnbh hhh hh hhhhbhhrbehhhenrrrhnhhahhhhrrhrhiahhhhhhhhhhhhhh 
4 yf 
pa Station Section 2 
yA Zz 


Rha Rhh hh hn hhhhhnhhhhhbhhhhhmahnehhhbhhhnerhnahhhe hhh hhh thhhih 


STATICN DEFAULT SYCOMDEF: 
FRECUENCY = 250.5 250. y “CS Controller 
MYUSE = INPUT» OUTPUT. 
TERVINAL = SYCOMTERMINAL. 
RETRY = 25. 


STATICN DEFAULT TCDSDF: Z*# 
FRECUENCY = 249» 249. Z*& NonmRemote ODT 
MYUSE = INPUT» OUTPUT. A&% 
TERPINAL = T0824. ate 


RETFY = 4. y es 


7 a eR ee ge nent rnc em ees area : pn ~ §=5 
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LLL AUL AZUL LL AAAI III III IIIA IAN IIIA III IAM AI IAS SA 


2% If any RJE station are required fer “RJE/HOST"» then they 
4% must be dectared LSN*s 1 ~- 4d ne excepticnSecesnsrxcrccacen 


STATICN CONTRCLST12 {~ seo =s= 
DEFAULT = SYCOMCEF. 4 isn 001 1 
ADDRESS = "00". a ] 
z 1 
STATICN SPOST2: y 4 j 
DEFAULT = SYCOMDEF. z isn 002 1 
ADDRESS = *01*. Z i Must be grouped. 
z I 
STATICN CARDST 32:2 Z > Stas aaa each 
DEFALLT = SYCOMDEF. y 4 tsn 003 I | | 
ADCRESS = "02". yA A 1 Don't have to be 
x j first stations 
STATICN PRINTERST4s 4 | defined. 
DEFAULT = SYCOMCEF. Z isn 004 |! 
ADDRESS = "03". 2 I 
Z / 
STATICN FILESTS: z | 
DEFALLT = SYCOMDEF. z tsn 005 I 
ADCFESS = "04". y a === === 


RRRRERARARULA RURAL ANRARAALRAARE ALAR EAA EA AAR ARE REAAA AA LA TELA AALS 


STATICN USERT15 y 4 isn 006 * Virtual terminal 
DEFAULT = SYCOMDEF. z CODT/terminats) 
ACDRESS = “"Aa™*»>» "aA". zZ 

4 

STATICN USERT2: yA isn 007 * Virtual Terminal 
DEFAULT = SYCOMCEF. yA C(Progran) 
ADDRESS = “"Pa™» "aP*. Zz | 


LLLAUL ALLL LLU L AULA II IAAI IIMS II I MIMI IIIA III NI 


| ak SSeS see = S= 

STATICN Ris ax**x tsn 008 ] 

DEFAULT = TU&éOF. yee i 

ADCRESS = "k1*. Lx J 

FREGCUENCY = 249» 25C. Z2x*x Remote ODT ! 

Zk j 

STATICN 2s 2**x tsn 009 1 

DEFAULT = TC&OF. Zw > Local terminal 

ADDFESS = “F2"™. Zee i 

FRECUENCY = 249» 25C. 2x Remote ODT I 

7 Za j 

STATICN R33 %** tsn 010 I 

DEFAULT TCSDF. 2x ! 

AQDFESS RS axe j 


FRECUENCY = 249 250. Z** Remote ODT | 


Zz 2 an 6e 08 Oe os ee et ee ee 
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Fp AARhbAa aah hhh hhh thhhhermAnnahkatmnhnrhhhramhnrhhhrhhhhrrryry* 
= y4 y 4 

; % Line Sectior : % 
% y4 


ALAREAAAEALLAAL AREAL RALALAA MALL AL AAR ZEAL RL AULA ALLE LLAL ELA LLZALLG 


LINE CIRECTO1: 


CONTROL = SYCOMCTL. 
STATION = CONTROLST1» SPOST2>» CARDSTZ» PRINTERST4» FILESTS» 
USEPRT1» USERT2. 

ACCRESS = 132036. yA Cline», adapter» ports system) 
LINE CEFAULT LINEDFLT= ye 

CONTROL = CANDETDCTIL. Zu & 

AUTCPOLL = 15. Z** 5 x max stations/lines 
LINE VWULTIO4: Z*#x adapter 4 

DEFALLT = LINEDFLT. Lae 

STATION = Ri»e R2e RZ. Z&*% 

ACDRESS = 1:20:24. Z*«x (line» adapters» ports system) 


hho hh he hte ia heh bla he lo nh ia hela te ea no bo lta fo ht elo A ke te ko ta tn fa ke te ht beta te fo be te fa to lo th a ha fa ta ba ba ha a 


FILE LINK: Z fer SYCO™M 
FAMILY = CONTROLST1» SPOST2» CARDST25» PRINTERST4&» FILESTS» 
- USERTIL. % rsn's O01» 002» O03» D04» 
( . z 005» 006 
FILE RFUSER: 2 Fer program@=tomprogram [/0- 
FAMILY = USERT2. 2 rsr 001 
FILE TERMINALS: Axx This file is named “TERMINALS* 


A®&® when SYCOM 185 run without the 

mee SMCS. It must be naned 

Zee "NCSREMOTE™ when SYCOM is run 

4**x subordinate to the SMCS.- 
FAMILY = Rive R2»e R3- 2** rsn's O01» OC2>» 9003 


y Sy Sa A ay Wy A Sy Sy Sy SS ey Say Sy a Si ay Sy Ay Sy yy Si Sa Ay Sp Sey aS Ay Se Ar Se ir A A Sie Sp A Si Ap i Ay i Sig SSeS Ay ir pd 


FINI. 


Notes If the User System does not have “local terminals” then 
ait tines in the above exdeaple with comments indicated 
with "Z*** can be omitted from the source file. 


SAMPLE NDL SOURCE FILE CREMOTE SERVER SYSTEM) 
Following is a sample NDL source fite to be used as input to. the 


NCL compiler for the generation of &¢ Network Centrottler oriented 
to a Server System. This example provides a Network Controller 


< enna ascot as 22S aes Va ia a Matis a agi yal na en he ie ‘ll Ee DY 2 sce Ey a RPM G3 Fh COA Shagny Wekeomton ey 5 ec Beli Vedran 
sevdlsge, ReamteeianaRtd pied Se Sol Ue te Peete See ho ahi oS ls ee ee SN a tl Pulsars ghd AB Salers omen 4 SSA Veit 


aa Sli GET TT la ian aoa enetensnte t t were a 2 _ ci nbn ear panies cist: a aes ns a ate eee ee oe sea a to a eS i oe ae ee s bea 
ARV ASE a 7 we tant at ery nn act nate tte aoe omens ae 
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which services one remote site of rc terminals» an interwsystem 


connection» and a SMCS. The user ust tailor these sample test 
Network Contrcller specifications te the needs and desires of the 
installation Ceege» more/less Local ad more/tless virtual 
termirals» etc). , | | 


This sample NDL input file is comprised of both NDL statements 
and parameter specifications. The resuiting Network Controttler 
will provide the correct functioral attributes necessary for the 
operation of the SYCOM systems in a test mode. 


$ CONTROL 
$ LIBINFO 
$ NSSIZE 20 Z runter of ertriess for IOLOG 
$ VSSIZE 150000 4 nunber of bits, for IOLOG 
DECLARATION: 

NIF = *"SERVER*/*NCNIF*. 2 NIF file namer user option 


MAX FILES = 16. 
MAX BUFFERS = 2. 
MAX MESSAGES = 20. 


$ LIBRARY SYCCMDECL 


$ LIBRARY SYCCPREG 
$ LIBRARY SYCOMCTL 


TERMINAL DEFAULT SYCOMDEFAULT: 
REQUEST = SYCOMRECSRECEIVEs SYCOMREQS TRANSMIT. 
TRANSMISSION = 1. 


ADLCRESS = 2. | % Number cf polling address characters 
BUFFERSIZE = 3840.~ 2% 2x #%192C bytes 
TYPE = 62. 2 B1B00: 


TERMINAL SYCOMTERMINAL: 
DEFAULT = SYCOMDEFAULT. 


OTATICN DEFAULT SYCOMDEF: | 
FREGUENCY = 250» 250. 2 MCS Contretler capability 
MYUSE = INPUT» OUTPUT. | . 
TERMINAL = SYCOMTERMINAL. 
RETRY = 25-6. 


REALL AULA E AZZ ALL ALAZAZZZ 
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STATICN CONTRCLST15 
DEFAULT = SYCOMCEF. 
ADDRESS = "Q0". 


STATICN SPOST2: 
DEFALLT = SYCOMCEF. 
ADCRESS = "01". 


STATICN CARDST2: 
DEFAULT = SYCOMCEF. 
ADCRESS = "02". 


STATICN PRINTERST4: 
DEFAULT = SYCOMDEF. 
ADDFESS = "03". 


STATICN FILESTS: 
DEFAULT SYCOMDEF. 
ADDRESS "O04". 


STATICN SERVEFRT1: 
DEFAULT = SYCOMCEF. 
ADDRESS = 


STATICN SERVERT25 
DEFALLT = SYCOMDEF. 


ADDFESS = “aP™» ™Pa" 


LINE CIRECTO1L: 
CONTROL = SYCOMCTL. 


STATION = CONTROLST1» SPOST2> 


SERVERT1>» 


ACOFRESS 1:0:36. 


FILE LINK: 


"aA"s "Aa. 


WE Pe WN RE TE REN NM BREN RE RE MN PE wR BN DE 


Se NN BE TE PEN PE 


SERVERT 2. 
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isr 001 1 
{ 
| 
| 
tsr 902 | 
] 
1 Must be grouped. 
| 
Lsn 003 > sSmeeeer see erwrere= 
i 
1 Don't have to be 
1 first stations 
tsr 004 ! defined. 
{ 
| 
| 
isr 005 ] 
j 
| 
isn 006 * Virtual terminal 
COOT/terminats) 
isn 007 * Virtual terminal 


CProgran) 


CARDST3» PRINTERST4» FILEST5S» 


% (line» edapter» ports system option) 


r 4 


fer SYCOM 


FAMILY = CONTROLST1» SPOST2» CARDST2» PRINTERST4» FILESTS~ 


FILE RFSERVER: 
FAMILY = SERVERT2. 


FILE MCSREMOTE: 
FAMILY = SERVERT1. 


rsn*s QCOl»s O02» 003» O04» 005 


Fer programto~wprogram 1/0. 
rsr O01 

Ncetes There is only 1 device 
defined here because the 
sz#ple test program is a 
sirgle user programe 


Tris file is used for the 
virtual terminals assigned 


SE eS lade» ck 2, 
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2 te Server System's SMCS. 
2 rsr Q01 | 


source configuration notes; 


The Network Controller source file for a Server System “with 
flocei terminets” is configured by appropriately adding the NOL 
statements identified in the User System example with %"%*2*" as 
comments. | : 7 
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OUTPUT AND ERROR MESSAGES 


GENERAL 


There are three basic types of output and error messages produced 
by the SYCOM system and its associated system software. These 
messages are Listed in their order cf presentation and identify 
the basic reasons for the occurrence cf these messages: 


1. Master Contrcl Program Mességes 
2. Network Controiter Messages 


2. SYCOM Error Messages 


MASTER CONTROL PROGRAM MESSAGES 


The Méster Control Program displays wessages in response to a 
contrcel instruction oor to inform the system operator of events 
that have or ére tc take places. ALt MCP output messages start in 
position 2 of the console printer/display. Refer to the 
B1800/81700 Systems System Software Crerational Guide for further 
information regarding these messagese 


NETWORK CONTROLLER ERROR MESSAGES 


Messages displayed by the Network Controller on the system ODOT 
generzlly describe error conditions encountered during normal 
system operations. The actual cutput tessages are displayed 
starting in pesition 2 and have the fctllowing format: 7 


<Network Controlter name> =<job number> <message text> 


The fcllowing error messages that can cccur while the Controtter 
1S executing are tisted in alphabetical order and explained as 
fallows: 


#RETRIES UP ON LINE <nuaber> 

The retry Limit is exhausted for the current message without 
keting acknowledged by the receiving system. The "<number>"* 
represents the data communicaticrs Line number as defined tn 
the Network Controller. 


MESSAGE RECEIVED FOR INVALID ADCRESS 
A message has been received with an address other than *00"%» 
"Oi", "02">5 "“O3">» or "04". The wessage is discarded. 
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MESSAGE RECEIVED FROM DISABLED STATION <tsn> | 

A message has been received for a staticr that there 1s no 
Fore room left to store the cutgoing tessage» The <lsn> 
represents the station's Logical Station Number as defined 
in the Network Controtler.~ The fessage is discarded. 


SYCOM ERROR MESSAGES 
During command processing various errors may cccurr the response 
error messages and their meanings are shown Celowe There are 
five classes cf these error messages: 

« Command Informational/Error Messages 

e system Parameter Error Messaqes 

- system Error Messages 

» System Conditicn Messages 


« System Fatal Messages 


The fcllowing error message groups describe all messages that may 
be dispiayed in each of the above identified message classes: 


COMMAND INFORMATIONAL/ERROR MESSAGES 


The following informational and errcr messages are displayed as 
the result of improper use of the SYCOM commands. Generally» an 
messace cén occur for one of three reéeadsonss they are? 


1. A existing condition when the command is entered 
2- Invalid command syntax 
Z. Invalid parameter data 


Although the reason for each message 1s reccgnizadle» there has 
been no ettemot to group the messages into these categories. The 
following command informational and error messages are however>e 
alphabetically grouped by command to make locating easier. 


UNRECOGNIZED COMMAND *<token>* 
This simply means that the tast SYCOM command entered was 
not a valid command. | 


NONmACCEPTABLE @<character>@ REPLACED WITH BLANK 

An unacceptable character has tCeen entered 31n a command 
string which 1s invalid to SYCOM. This message informs the 
user that this has occurred and has been corrected. 


oes Saece #Gemepestesteus te asst cg v's Slane foecan cope nent EE me ten Te da eechehde libtool fae nee” hae ty ge bee eo ere See pothe” ty hi tag ‘op “ue atly sg side pa ee tie! rectaatiohooiathat Bi. BT abbas RRR as 
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SYCOM CLCSINGE<message>J]s> CANNOT ACCEPT INPUT 

This message is returned in response to any new command 
entered “after™ an “™.E0J™" coamand is entered but prior to 
the actuael shutdown of SYCOM. (Once shutdown has “been 
initiated» commands are no Lonocer acceptede) 


ABORT 


THERE IS NO “PUT™ IN PROGRESS TC ABORT 
An ABORT command was entered nith a specified option of of 
"PUT™ and no file is being trarsmitted at this time. 


THERE IS NO “FETCH® IN PROGRESS TO ABORT 
An ABORT coamand was entered with a specified option of of 
"FETCH" and ro file 1s being received at this timee 


UNRECOGNIZED OBJECT OF *"ABORT™ *<token>* 
The command was entered with an option keyword which was 
neither “PUT™ or “FETCH™. Try 2gainece 


BUFFER 


BUFFER SIZE “<token>* EXCEEDS MAXIMUM ALLOWABLE 195090 # £=RUN 
TIME TRANSMISSION BUFFER SIZE CHANGED TO 1950 

This stmply means that the value entered for the new “*huffer 
size" is unacceptable. Therefcres SYCOM not knowina the 
intention of the change» has automatically set the BUFFER 
SIZE to its faxisume | 


NEW BUFFER SIZE IS LESS THAN 362 RUN TIME TRANSMISSION 
BUFFER SIZE CHANGED T0 362 

This means exactly what it reeds» a vatue less than 7362" 
was entered as a “buffer size” ard SYCOM automatically set 
the BUFFER SIZE to It minimus. It should be pointed out» 
howevers that this size will te unacceptable for proper 
SYCGM operations. 


CL 
UNRECOGNIZED COMMAND “CL <token>®* 
The eCL command was entered either without an option or the 
cption was found to be invalid. | 
CONNECT 


STATION ALREADY CONNECTED 

This only means that a *.CONNECI™ command was entered from a 
terminal Cor ODT) that was already “connected” to a Server 
systems no problem. 
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COPY 


“CONNECT FAILED": VIRTUAL TERMINAL TABLE FULL 

This message displayed irdicates that all allocated “virtual 
terminal" positions are currently in usee The terminal user 
must try again at a later time. _ 


NOT DONE SINCE OFFLINE OR LOGGEC OFF 

This message suqgests that the request to “connect”: has 
failed tbecause®> 1) the remote SYCOM is OFFLINE or 2) the 
user is rot properly lcgged-on to SYCOM. | 


CAN®T SCHEDULE NOWs TRY AGAIN LATER 
The “PUT/FETCH queue™ is presently full» therefore» no more 
"PUT's” or “FETCH"s*® can be accepted at this time. 


REQUEST SCHEDULEDs WILL SEND FILE <file name> LATER 

The PUT/FETCH request was cueued to disk and witt be 
processed as soon as in=process and previously queued file 
transfers have teen coagptleted. 


REQUEST SCHEDULED“"“REMOTE SYCOM OFFLINE 

The PUT/FETCH requested has been queued to disk and will be 
processed as soon as communications have been ren~established 
between the User and Server systems. 


"“<token>* UNRECOGNIZED 

No required keyword text has been entered such as "TO"» 
"ONTO"s»s or “FROM"s» $therefores what was entered in error 1s 
cisplayedc in this message. 


INVALID USERCODE *<token>* : 7 
The “usercode™ entered was rejected tecause it contains 
nonmalphebetic characters. What was entered in error is 
cisplayed in the error message. 


USERCODE MAY NOT HAVE MORE THAN 17 CHARACTERS 
The length of the “usercode* ‘entered exceeded a maximum 
allowable length of 17 characters. 


SQURCE HOST **" NOT DEFINED OR REMOTE HOST “* NOT ONLINE 
An invalid “host system nane" has been specified. It is 
applicable to either the “source” or “resmote™ name. 


INVALID PASSWORD 

The “password” entered was rejected because it contains 
nonmalphsketic characters. This usually caused only by 
"Lesding™ ainvatid characters @s opposed to imbedded or 
trailing tnvalid characters. | 


PASSWORD MAY NOT HAVE MORE THAN 17 CHARACTERS 
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The length of the “password” entered exceeded a naximumn 
~ellowable Length of 17 characters. 


INVALID FILE ATTRIBUTES <token> 
The command syntax keyword "US" or *USER™ was expected and 
rot found in the command syntax. 


INVALID FILE ATTRIBUTE DELIMITERS “*<token>* 
The "COPY" syntax requires a conma "»" between the attribute 
"“<usercode>”™ and the keyword “PASSWORD”. 


FILE NAME MISSING 
The command syntax requires a “file name” specified for a 
file transfers it was either not given or recognized. 


KIND DEFINED TWICE 
The “KINO™ option keyword has been previously specified tn 
the commend strifrge 


INVALID KIND ATTRIBUTE *<token>* 
The kind option keyword was not “PACK™s “PETAPE"» “"TAPE"» 
"TAPE7"» or “TAPES” which makes what was entered invatid. 


INVALID HOST NAME 

The host system name enterec was rejected because it 
contained nonwalphabetic charéecters. This message could 
apply to either the “scurce™ or “remote” Rost name. 


HOST NAME HAS MORE THAN 17 CHARACTERS 

When a host system name tS entered with more than 17 
characters Cmaximunm allowable). This message could apply to 
either the ™source™ or "remote™ host namee 


UNRECOGNIZABLE VOLUME ATTRIBUTE “<token>* 

This message 1s somewhat misteacing in that it is onty = an 
indication that a keyword of *KIND™ or "HOST" was expected 
end not fcund.e 


MISSING *%»* BETWEEN VOLUME ATTRIBUTES 

An attribute separator character cf “"»" is required by the 
command syntax to indicate the end of the attribute “KIND” 
and its associated ootion keyworc. It is not there and it 
1s wanted. 


VOLUME NAME HAS MORE THAN 17 CHARACTERS 

The “volume name™ Cor packwid) ertered exceeded the maximun 
allowable Length of 17 characters. This message could 
relate te either “*volumew1" or “vyclume 2" ramese 


INVALID SOURCE HOST NAME “<token>" 

The system identifier specified as -a “source host™ does not 
match the “lecal™ system name» the “"“remote™ system name» and 
is not blanks. The request is ret processed. 
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FILE <file name> NOT OPENED [£1] OUTPUT PACK NOT FOUND : 
During SYCOM's file openwonwbehalif~of processing» the MCP 
returns a value for the last cotmunicate issuedj This value 
indicates that the requirec destination pack is not. 
currently online. | 2 - | 


FILE <file name> NOT OPENED €4] INVALID USERCODE/PASSWORD 
The MCP has informed SYCOM that the open ~on-bdenhal f-of 
request has been rejected because the Usercode/Password 
combinaticn used was fcund to te invalid. 


FILE <file name> NOT FOUND £1] INPUT FILE MISSING 
The object fite for a PUT file transfer was not found in the 
cCisk directory Cdisk) or was not cntine Ctape or disk pack). 


FILE <file name> NOT FOUND £21 FILE LOCKED 

The MCP has informed SYCOM that the openton~behal f-of 
request has been rejected because the target file is 
currently "Locked". 


FILE <file nagwe> NOT FOUND €3] NO USERCODE FILE | 

The MCP has informed SYCOM that the open~on~behal f~-of 
request has teen rejected because the CSYSTEMI/USERCODE file 
coes not exists it 18S required. 


FILE <filte name> NOT FOUND (€4] INVALID USERCODE/PASSWORD 

The MCP has informed SYCOM that the openron-behal f-of 
request has been rejected because the Usercode/Password 
combination used was found to te invalid. 


FILE <file name> NOT FOUND [5] VIOLATES USERCODE CONVENTION 

The MCP has informed SYCOM that the opentonbehal f-of 
request has beer rejected because the Usercode/Password 
combination entered is not privilegeds as required. 


FILE <file name> NOT FOUND (€6] SECURITY TYPE ERROR 

The MCP has informed SYCOM that the openwonmbehal f-of 
request has been rejected because no Usercode/Password was 
entered when 1t 1s required. | 


FILE <fite name> NOY FOUND [£7] SECURITY USE ERROR | 
The MCP has informed SYCOQM that the open~onbehatfrof 
request has been rejected because a nonwprivileged user is 
trying to access a privileged file. 


FILE <file name> NOT FOUND (€8] EXECUTE ONLY FILE 

The fite requested for transfer is flacged by the MCP as a 
nonmaccessibdle file for internel execution only and the 
request has been rejected for that reasor.e 


FILE <file name> NOT OPENED €91] WOULD BE DISCARDED 

The MCP would discard the file at the end of transmission 
Ceege attempt to create a non usercoded file by a 
ron-privileged user). i 7 
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FILE <file name> LOCKED 


The object file for a PUT file transfer was found to be 
"lLocked™ in the aisk directory (C(cisk). 


FILE <file name> FILE TYPE CANNOT BE TRANSMITTED 
The disk file specified for fite transfer is not one of the 
file types which SYCOM can transfer. 


SOURCE OR DESTINATION FILE NAME MISSING 

This message indicates that a subject file name was missing 
from the command string which was entered as either a 
“COPY™%>» “PUT"» or “FETCH” from egroether system. 


SOURCE OR DESTINATION FILE NAME “<token>* INVALID 

The specified file name was found to contain characters 
cther thén those which are ccrsidered valid for ae file 
identifiers ors a multirtfile icentifier was indicated ("/") 
but was not included. 


FILE NAME WAS IDENTIFIED WITH MGRE THAN 10 CHARACTERS 

The name of the file to be trarsm@itted was found to contain 
an identifier in excess of 10 characters. Its the maximum 
allowable. 


CANNOT LIST THIS FILE - NOT A BACKUP FILE 

A file wés received from another system and was flagged for 
“auto print™. This message explains the reason for not 
coing it and would correspond tc the "<file name> RECEIVED" 
CDT message. 


FILE <file name> ALREADY EXISTS AT DESTINATION - PUT ABORTED 
When SYCCOM is setting up to “receive” a disk Cor pack) file» 


it checks to disk directory. If the specified file already 
exists» this message is displayed and the transfer is 
zéborted. 


FILE FAMILY NOT ALLOWED 

As suspected» in the specified file name>» an equal sian 
C"=") was found which represented either a “pack~id™» 
"multi-filetid™. This is ittecals the file named must be 
specific. 


CEBUG ALREADY ON 
The command was entered to turn DEBUG "ON" which was 
currently one 
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DEBUG WAS ALREADY OFF eee 
The command was entered to turn OEBUG “OFF™ which was 
currently off. | _ _ a 7 


ERROR - “GN" OR “OFF* OR *DUMP™ EXPECTED 


The option keyword entered with the DEBUG command is not 


valid. Please try again. 


DISCONNECT 


EQJ 


STATION ALREADY DISCONNECTED | 
This only means that a “DISCONNECT™ message was entered from 
a terminal that was already disccnnectedr it was ignored. 


STOP OR WAIT IN PROGRESS 

This means that a “eHAIT™ commard has been entered and SYCOM 
1s responding te that requests the “".eE0J" command is 
ignored. | | 


FETCH Calso see COPY) 


LIST 


CANNOT FETCH WHEN REMOTE SYCOM CFFLINE 

This message 1s indication that an interwsystem Line 
connection dces not presently exist and the “FETCH” request 
cannot be accomsocated. 


SGURCE OR HOST NAMES MAY NOT BE DEFINED IN A FETCH 
Lse of the shorthand versior CFETCH) of the COPY command 


implies the source and destinaticn systems» therefore» they 
cannot be specified. 


FILE <filte name> IN USE AT DESTINATION““FETCH ABORTED 

The file in question was received and when attempting to 
close it (which removes any existing file copy)» =finds that 
the fiie to be replaceca is currently in use. The FETCH is 
aborted and the received file is losts it must be requested 
aggGaine 


UNRECOGNIZED OPERAND “<token>* | | | 
This sitgaply means that an inccrrect or misspelted option 
keyword was entereds and rejectec. 


NQ PARAMETERCS) SPECIFIED FOR “LIST™ 
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The command was entered without any keyword options. 


FEMOTE SYCOM IS OFFLINE] LAST COUNT OF FETCHES WAS Q 
This messace is self explanatory. 


OFFLINE 


STOP OR WAIT IN PROGRESS 

This message indicates that SYCOM is in the process of 
servicing a “eHAIT" command which in effect produces an 
"offline" conditions the ".OFFLINE™ comsgand is ignored. 


PHONE 


INVALID PHONE NO 


This message 1s returned wher the phone number entered 
contains alphabetic characters. 


PHONE NUMEER TCO LONG 


This message is returned wher the phone number entered 
contains more than 20 digits Circluding hyphens). 


PHONE NUMEER REJECTED BY NC *"<phone nusaber>* 
my The Network Controller has rejected the request by SYCOM to 
/ change the existing “phone number™ to the one entered,» no 
reason wes specified for the rejectione 


PUT Calso see COPY) 


CANNOT PUT WHEN REMOTE SYCOM OFFLINE 
This message means that an interssyste® connection does no 
rresently exist» therefore» a “PUT™ cannot be done. The 


request» however» is saved ir the "PUTQUEUE* for tater 
transmissione 


SOURCE OR DESTINATION HOST NAMES MAY NOT BE DEFINED IN PUT 


Lse of the shorthand versicr CPUT) af the COPY command 
implies the source and destination systems» therefores they 
cannot be specified in the commend string. 


PUT OF FILE <file nase> ABORTED 

This message occurs when SYCOM is attempting to “send™ a 
file to the other system and the specified file is currently 
in use cn that systeme The PUT is aborted. 


QS 


ERROR: “.QS" OPERAND NOT NUMERIC 
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The “e€S" command is entered with a non=numeric queue size 
integer field and was ignored. It is necessary to re~menter 
the command strirg in correct fcrmat. | 


ERROR: QS" OPERAND MAY NOT EXCEED 15 | 

The queue size integer entered was greater than 15 and was 
summarily rejected. It must be re*entered with an 
appropriate integer value. 


ERRORS “QS* OGPERAND MUST BE AT LEAST 4 


The queue size integer entered was tess than the value 4 and 


was rejected. The command #ust be rerentered with a 
legitimate integer value. 


READ 
REQUEST IGNORED: CARD FILE STILL OPEN 
This message is displayec if a "sREAD" command is entered 
when an input card file is currently active. The entire 
command string is rejected arc ciscarded. 
REQUEST IGNORED: NOT LOGGED ON 4,3 
This message could mean the carc reader is not ready. 

FILE "<file-name>" NOT PRESENT» TRY AGAIN 

The command “.READ™ was entered and the card or disk fite 
"<file-name>" is not presente 

RESTART 
11 consecutive timeoutse Resote SYCOM presumed “OFFLINE™ AT 
083222:29.1 ON 16 AUG 79 
This 1385 a dtrect tndication that the remote system is not 
responding to the tocal SYCOM™M procedures and 1s considered 
to be tin an OFFLINE state. 

RY 
UNRECOGNIZED COMMAND “RY <taken>* 
The command string contatnec an unrecognizable option 
keywords not "CP". “"LP*™» or “CK. 

SIZE 


ERRORS “.SIZE™ OPERAND NOT NUMERIC 


The integer entered with the coamand string was comprised of > 


et least one nonwdigit character. The integer must be alt 
digits» no exceptions. 


ERROR: “.sSIZE" CANNOT EXCEED 400 
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STOP 


SV 


TRACE 


USER 


This message is displayed when @€ size integer is entered 
which exceeds the maximum messace block size established for 
the systems four hundred €4C90) tytes. 


ERRORS “*.SIZE* CANNOT BE LESS THAN 78 

This message is displayed when the size integer entered 15 
less than the minimum allcwable message block size» for 
this system the minimut size is 7& bytes. 


This command cannot directly cause an error message. 


UNRECOGNIZED COMMAND “SV <token>* 
The -SV command was entered either without an option or the 
cption entered was found to te irvatid Cnot “LP*™ or "CP*). 


CISK TRACE ALREADY ON 


The command was entered toc turn tracina “ON"™ and SYCOM was 
elready in trace mode. 


DISK TRACE WAS ALREADY OFF 


The command was entered to turn tracing “OFF™" and SYCOM = was 
not currently tn trace mode. 


ERROR ~ *°ON* OR “OFF™ EXPECTED 
The only valid options to the TRACE command are “ON%» “OFF™ 
cr no option specified. 


INVALID USERCODE “<token>* 

The usercode used to togwmon with was found to contain 
digits. Plhease togroff and tlogmon again with correct 
usercode/password combination. 


INVALID PASSWORD *<token>" 

The password which the user sicred“on with was found to 
contain digits.» Please tlootoff and tlog~won again with a 
legitimate usercode/password ccsbtination. 


CANNOT SIGN ON IN 8.0 INDIRECT MODE. PROTOCOL 2 WILL USE 
USERCODE/PASSWORD FROM SMCS IF SIGNED ON 

The user attempted to PASS “"eus usercode/password™ to SYCOM 
without Ceing “Logged~on"™ to the SMCS. . 
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"SYSTEM PARAMETER ERROR MESSAGES 


The fcllowing error messages could occur during the parameters 
input process. The problem indicated arpolies to both ODT input 
as well as card inpute In either case» SYCOM must be DS'de the 
problem(s) corrected» and the parameters reentered as required. 


INVALID PARAMETERS “<token>* 
This message is disptayed when the parameter keyword entered 
cid not watch one of the accepteble keywords. 


t=4 EXPECTED BUT GOT “<token>* 
A parameter was entered with a value which must be separated 
ty the equal C=) character. 


INTEGER EXPECTED BUT GOT *<token>* 

The BUFFER and RECORD parameters require an integer which 
specifies the BUFFER/RECORD size in bytes. As this 1s not 
what was entered» what was founc is included in the message- 


BUFFER SIZE “<token>*™ EXCEEDS MAXIMUM ALLOWABLE 1950 
The maximua altowable BUFFER size is 1950 bytes. What was 
specified exceeded this Limit. | 


INVALID SYSTEM ID “"<token>* TOG LONG 

The “system id™ entered has either exceeded the parameter 
size limit of 17 bytes» it was excluded altogether» or 
spectal characters have been detected. 


INVALID PARAMETERS FILE» BEING REMOVED 

This message occurs when the “PARAMETERS™ file is opened» 
the parameters read ine and the version is incorrect or the 
"maximum cbCuffer size” was found tc exceed the system maximum 
cf 1950 bytes. When this ccndition is encountered» the 
"SYCOM/PARAMETERS™ file is remecved and new parameters must 
te entered. 


SYSTEM WARNING MESSAGES 


Warning messages displayed on the User ODT indicate a problem at 
the system Level. They have been rectified by SYCOM so that 
operations can continue without operétor intervention. They are 
not generally considered to be major cr extensive in nature and 


therefore» SYCOM has elected to take tmmediate corrective action. 


#2 WARNING ~ REMOTE HOST NAME SAME AS LOCAL SYSTEM ID. 

This preblem is resolved by stopping SYCOM and recreating 
the “SYCCM/PARAMETERS” file with an appropriate “SYSTEMID* 
change or using eSYSTEMID commard. = 


ING OVERFLOW» FOLLOWING MSG DISCARDED <60 or Less characters 
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of message> 

If during a Write to a Program~to~mSYCOM application program 
en “incecrplete1i/o0" cccurs»e this message is displayed to 
provide the warning for this ccncition.e 


TERMINALS FILE OVERFLOW, MESSAGE DISCARDED <60 or tess 
characters of sessage> 

If during a message Write to the remote file TERMINALS an 
"incosplete"1/0" occurs» the atove message ts disolayed to 
inform the system operator of this condition. 


INCOMPLETE IO ON LINK FILE IGNORED 

CR 

INCOMPLETE IO ON TERMINALS FILE IGNORED 

OR 

INCOMPLETE I0 ON OUTQ FILE IGNORED 

The comnplex"wait has interrupted SYCOM for either the LINK» 
TERMINALS» oor QUTA file and the Result Descriptor indicates 


an “incorgplete i/o” has occurrece This error 1s logged and 
SYCOM reverts back to “wait” soce. | 


co, LINK QUEUE OVERFLOW» MESSAGE DISCARDED 
(> The queue “LINK.«Q@" is full» therefore» ro more messages can 
= be queued at this time. The fwessage in question is dumped 


~és there is nothing SYCOM car dc with ite 


NUMBER OF TIMEOUTS = <nuaber> 
This message is displayed automatically when "*timeouts” keep 


reoccurring on the interwsystem Lire ccnnection. It is 
onty outtut on an incremental basis (€nd to reduce ODT 
activity», where <n> as specified in the “TIMEQUTS” 


parameter. 


LOSS OF DATA "SET-“READY 

Display of this message occurs each time the tndicated event 
1s detected. <A count 1s maintained of these occurrences and 
SYCGM goes into the state of “*iritializatioan”. In progress 
file transfers are aborted and toste If this continuously 
cccurs at BOJ» the adapter may te incorrectly straoped. 


HOST SYSTEM CARD READER HALTED 
When this Message occurs 1t 1s to inform the system operator 
of @ condition that presently exists on the remote system. 


HOST SYSTEM CARD READER ABORTED 

This Message is used to inform the system operator that card 
reader input from the remote system has been aborted. No 
éction is required of the operatcre 


HOST SYSTEM CARD READER READY 
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A message that is used to infcrm the tccal system operator 
that card input “oe the remote system has resumede 


SYCOM WILL CLOSE WHEN NEXT IDLE 

The "EOJ" command has been enterec and SYCOM is processing 
previously entered requests. hhen these requests have been 
rrocesseds SYCOM wiil terminate. | 


4#@ SPURIOQUS -«CONNECT IGNORED #2 
This meaning 1s clears, SYCCM was interrupted with an 
unknown “connect” message which it ignored. 


4% SPURIOUS -DISCONNECT IGNORED #32 | 
The meaning of this message 1s clear> SYCOM was interrupted 
With an unknown “cisconnect™ message which it ignored. 


SYCOM CLOSING ON REQUEST FROM REMOTE SYCOM 

The remote SYCOM program has been directed to go to "“E0J" by 
the entry of either "E0J” or "STOP" from that system. When 
this occurs» it sends a control type sessage to the other 
SYCGM which causes the above message to te displayed. 


ERROR: MESSAGE TYPE = <type code> 


An input message from the remote file “LINK™ was found to be. 
invalid. The message type code is included in the displayed 


error message for reference. 


REMOTE SYCOM HAS GONE DOWN AND COME BACK UP 
This message is setf explanatory in that for some reason the 
remote SYCOM disconnected the lire ard then re-established 


communication with this SYCOM resulting in the above message 


being displayed on the systes CCT. 


CUEUE RJEQ FULL» MESSAGE DISCARDED 
The queue “RJE.Q" is full» therefore» no more messages can 
be queued to it and the current message is discarded. 


2#2# WARNING - NO *SYSTEMID™ #22 

Lpon completion of the accept SYCOM parameters process» it 
was determined that a "systemric™ has not been = specified 
Ceither rot entered or was ir error). 


SYSTEM CONDITICN MESSAGES 


Any of the following messages displeyed on the User ODT indicate 
an abnormal system condition of some type. As a rule» when. one 
of these conditions is encountered» the display of an appropriate 
message also elicits a response frog the system operator. 


CARD PUNCH EXCEPTION PLEASE ENTER "sRY CP" WHEN DEVICE Is 
READY OR “sSV CP™ TO SAVE THE FILE 


ARTS 
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Aw-15 


BURROUGHS CORPCRATION COMPANY CONFIDENTIAL 


COMPLIER SYSTEMS GROUP B1800/81700 SYCOM 
SANTA BARBARA PLANT Pe Se 2219 0458 CA) 


This message ts displayed when SYCOM is attempting to punch 
a@ card and an “exception™ condition 1s encountered. 
Cenerally this indicates that the card punch has gone “not 
ready™ for any one of several reasons. It is necessary to 
respond to SYCCM with the apprepriate command when action 
ras been taken to ready the unite | 


LINE PRINTER EXCEPTION PLEASE ENTER “.RY LP® WHEN DEVICE IS 
READY OR “.2SV LP™ TO SAVE THE FILE 

This message is displayed when SYCOM is attempting to print 
é tine and an *"exception™ condition 1s encountered. 
Generalty this indicates that the line printer has gone “not 
ready” for any one of several rezsonse It is necessary to 
respond to SYCOM with the apgrcpriate command when action 
has been taken to ready the unit. 


PARITY ERROR ON READ PLEASE READ LAST CARD AGAIN 

This messége is displayed when SYCOM 3s attempting to read 
the card file and an “exception” condition is enccuntered. 
Cenerally this tirdicates that the card reader has gone “not 
ready™ for any one of several reasonse It is necessary to 
respond to SYCOM with the aprrocriate command when action 
has been taken to ready the unit. 


<message text>: BAD LSN = <sessage tsn> 

When writing a reply message to a terminal» an “EOF” status 
was encountered and SYCOM assumed that an invalid “isn"™ was 
the cause. Therefore» that messzege text is displayed on the 
System OCT as part of the above ftessage. No further action 
1s taken on the part of SYCO™M. 


<message text>: INVALID LSN = <message lLsn> 

Khen writing a reply message to a terminal» an “EOF™ status 
was encountered and SYCOM assumed that an invalid "itsn" was 
the cause. Therefore» that wessage text is displayed on the 
System OCT as part of the above fressage. No further action 
has been taken by SYCO™M tn this matter. 


PUNCH ERRCR 

The card punch has either detectec an error in the last card 
punched or has degraded into a “not ready” statee In etther 
case» 2 "suspend" contret s#essage has been sent to the 
Server System. 
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READER ERROR oie oy | 
The card reader has either cetected an oerror in the last 


card read» gone into a “not reacy™ state» or has detected an 


invalid character tn a card cclugns other than column 1. 
If there was a fread errore tke last card must be put back 
into the card hopper. The card reader 1s then made 


thysically “"ready"> alt casese SYCOM must then be informed 
of this new status condition with the entry of a "™eREADY* 
commands : | 


PRINTER ERROR | 3 | : 

The Line printer hnras either cetected an error on the tast 
line printed or has aqone inte @ "not ready” state. In both 
cases a “suspend™ control message is sent to the Server 
Systeme hhen everything is again ready with the printers» a 
"READY" command must be enterec to inform SYCOM. 


CARD READER CLOSED 7 
This simply means the card input has been completed and the 


card file claosede 


CC INITIATED | | 
In doing a read on the remote file "LINK™ an "EOF" condition 
was detected. This conditicr is caused by the MCP when a 
"QC™ command is entered, whick shuts down att programs 
associated with the Network Controtler. 


NO PHONE NUMBER | | 
This is i andication that wher attempting to establish 
communications with another system» SYCOM determined “auto 
dialwup™ was necessary but the required phone number is not 
present. | | 


INVALID CONTROL MESSAGE RECEIVED = <message text> 

kKhen SYCQPM receives a system “ccntrol wessage”™ from a remote 
System anc the “type code™* in this messace 15 not within the 
CO - 23 number range» then the above message 1s displayed. 
The input message is discarded ard no further processing is 
done on its behalf. 


BUG IN NETWORK CONTROLLER] VIT INDEX = <vtt> I.E. STATION 
WAS NOT CONNECTED OR WRONG LSN IN CLOSE MESSAGE. 

A "close" message has been received from tne system Network 
Controtler for a prograan known to SYCOM which contained a 
"isn list™. $$ This list ircluced a Virtual Terminat Table 
Index CVTT INDEX) entry for a terminal not signed~on to that 
programs thus the reason for this message. 


REMOTE SYCOM TERMINATED 
This message incicates that the communtcattons link between 
the two Systems has been interrurted for some reasone SYCOM 


will attempt to reestablish the coareceT oe and failing that 


reverts to "“Cffline aEencoy™ mOoces 


“= “16 
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SYSTEM FATAL MESSAGES 


These messages are of the type whick creclude the automatic shut 
down of SYCC#. There are considered “fatal” in the outtook of 
continuing operations and therefcres» SYCOM is shut down. 


FATAL ERROR AT <prograsg sequence number> <message> 

The display of this message on the User ODT could be _ the 
result of any number of reasonSe The SYCQGM source sequence 
rumcer displayec is the only clue to the problem. SYCOM 
initiates a “Listwdisk*trace™ and a "memory dump” at this 
and automaticatly goes to EQ. after certain disconnect 
functions have been satisfied. 


REMOTE VERSION OF SYCcO™ Is INCOMPATIBLE HIS 
VERSTON="<version nuagber>*»s MINE="02° 

This message identifies the rrotlem at hand. SYCOM goes to 
EQJ immediately at this points This version is determined 
ty the SCS. 


ANOTHER SYCOM WITH SAME MULTI“FILE-ID IS RUNNING 

The disptay of this message indicates that SYCOM cannot gain 
eéccess te the “SYCOM/PUT.QUELE"™ file Con disk) as it is 
rresentiy in use by another procrame 


REMGVE PUT-QUEUE OR CHANGE ITS NAME IF 7.20 FILE 
If the disk file by that name is less than 99 recordss when 
reading it» SYCOM will get an “EQF" and aborts immediately. 
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APPENDIX Bs CHARACTER SET 


The following graphic character set defines those characters that 
are acceptable to SYCOQM as input. Ttese characters can be in the 
form cf terminal tinput/output messages» data files or intersystenm 
contrecl messacess» Qther characters incountered by SYCOM will he 
dealt with as per the established "file transfer™ rules. 


The graphic character set is arranged in “rows” by the internal 
collating sequence with “blank” being lowest and "9" high: 


blank [ ° < C + ! & ] $ * ) ; 
_ = / a » y 4 =. | > eg : # aq : 
= . a b Cc d e f gq h i j k 
t m n 0 Dp q r Ss t u Vv id x 
y 2 A B Cc Dp « F G H I J K 
L M N 0 P Q R \ 3 T U V | 
X Y Z 0 1 2 3 4 5 6 7 8 9 


It 1s recommended that the standard “signal character” of *." be 
retaired by the SYCOM for use as a lIccat SYCOM message switching 
character. Howevers if this is not suitable for any reasons one 
the fcllowing special characters is suggested? CA very important 
point to note is that when changing SYCOM's “signal character", 
do assign a character which conflicts with the systea'ts current 
"SMCS signal character". ) 


{[ & $ % J} #& 2a + 
Speciel data communications characters recognized by SYCOM ares 


SOH EQT DLE ENQ STX ETX RS FS 


| ; | B-1 
- BURROUGHS CORPCRATION 7 «COMPANY CONFIDENTIAL 


BURROLGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


COMPANY CONFIDENTIAL 
B1800/B1700 SYCOM 
Pe Se 2219 0458 CA) 


APPENDIX Cs COMMAND SUMMARY 


The fcllowing command summary List is presented in alphabetical 
sequence for easy reference. Refer to the command descriptions 
for ccamand syrtax and option details. 


i 
LABOR] | any 
1 j 
1AD0 { any 
1 | 
i j 
IBUFFER i any a 
| 1 
IBYE i any 
j i 
ICL i ODT 
| | 
ICONNECT : any 
I | 
1 i 
IiCGPY I any 
I ] 
i i 
IcP j ODT 
J i 
IDEBUG i any q 
1 i 
IDISCCNNECT 1 any 
l ! 
PEOJ 1 ODT 
i - 
IFETCr i any 
I I 
IGROUFSIZE 1 any q 
I 1 
i j 
ILIST j any 
1 j 
1LOG 1 any a 
j | 
1 j 
ILP i ODT 
i : I 
IOFFLINE COT 
{ 


—a am met om. i oa ome et ae ee le ee ee oe ee ee ee el le ee ee le le lee ee lee le ee le ee es ee le le Ole 


FUNCTION 


Abort aPUTY or FETCH file transfer. 


Transfer 2a file tf it does not already 
exist at the destiration 


Query or change transmission block size. 
Station tccwoff from SYCOM. 
Clear peripherat device. 


Request establishment of a terminal to a 
Server System. 


Transfer <~ fite Cregardless of whether 
or not it exists at the destination) 


Inform SYCOM of “not ready” peripheral. 
Start/stcop input/output nessage tracinge 
Request fer terminal disconnection from 
the Server System. 

Cause SYCCM into an orderly shutdown. 


File transfers Cfetch from other system) 


Set or interrogate group size for 
transfers of families fo files 


Display selective system information. 


Display a List of data comm error counts 
and orcegras statistics 


Inform SYCCM Line printer "not ready". 


Cause SYCCM to break the connection to a 
server Systeme 
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1 
1 
! 
I 
! 
1 
1 
i 
I 
1 
i 
I 
! 
1 
1 
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t 
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1 
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! 
J 
| 
1 
I 
1 
1 
i 
! 
| 
i 
i 
j 
j 
1 
i 
{ 
i 
{ 
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ONLINE 


I ~—ODT 
J | 
IPHONE ] any a 
i 
] j 
iPROGRAM 1 any a 
I 1 
IPUT 1 any 
i | 
1Q3 i ODT a 
! i 
| ! 
TREAD | ODT 
1 ] 
IRESTART | ODT 
| i 
TRY | ODT 
i 1 
ISIGNAL 1 any 
! | 
] | 
ISIZE i any q 
I i 
isToPp j OOT 
} ] 
1SV i CDT 
1 i 
ISYSTEMID i any a 
1 i 
J j 
ITRATE j any c 
1 ] 
FUSER i any 
| i 
IWAIT ] any qa 
I ] 
i f 
TWHAT i any 
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Establish a Server System connections. 


Establish or ie phone number . 
Server system. 


queue or change program parameter 


File transfers Cput to other system). 


Query or change Network Controller queue 


depth sizee 


Open and transmit card input file. 


Disconnect tine» initialize and standby. 


Inform SYCOM of availabie peripheral. 


Query or change SYCOM station's pseudo 


signal "character. 

Change Maxifum wessage Dlock size. 
Cause SYCOM to shutdewn immediately. 
Stop transmitting and “save” file. 


Interrogate or charge value of SYSTEMID 
parameter | 


Start/Stoep SYCOM I/0 disk tracing. 
Log a user onto SYCOM. 


Interrcegate or change value of WAIT 
parameter 


SYCOM status inquirye 


C-2. 
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APPENDIX OS SYNTACTICAL KEYWORD SUMMARY 


Syntactical keywords wilt be reccgnized by SYCOM when they appear 
within specific context within the command string syntaxe Should 
a specified “file name™ happen to match one cf these “keywords”™» 
qo nct worrys for this is a perfecttly acceptable use of a keyword 
outside of the command syntactical ccrtexte A comolete summary 
of these keywords follows: 


AS BINARY CLEAR cp CR 
DISK DUMP FETCH FROM HOST 
KIND LIST LP NO NR 
OFF OLDTRACE ON ONTO PACK 
PARAMETERS PASSWORD PETAPE PUT PUTQUEUE 
REMOVE SAVE SCHEDULE TAPE TAPE? 

oo, TAFES TERMINALS TO TRACE US 

C 


weal USER USERS 
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APPENDIX Es COMMUNICATIONS CONTROL MESSAGES 


GENERAL _ 


As there are several message formats used for inter-SYCOM data 
compunicationss each format is specified in detail-e These 
message formats are presented ir a seauence dictated by the 
messace type codee A list of messace types are shown below» 
followed by individual message format cescrtptions. 


MESSAGE TYPES 


The message type codes are derivatives from the "DAI"/"DA2"* 
(Device Address) field. The message type codes apply to message 


transmissions in either direction and are compatible between 


system types. Following then are the device address conventions 
used Ly SYCOMs ali cther vaiues are ccnsidered invalid: 


| DA1 1! CA2 4% #£40Usage i 
i 0 0 i System control J 
0 1 ODOT messages 
0 2 Card reader/purch data wessages 
0 3 line printer data messages 
0 4 


File transfer cata messages 


Oe ee ee ee ee 
ps) 
i» 


! ! 

{ i 

i | 

1 I 

| j 

3 2 i Packed card purch data wessages } 
1 | { 

i User System “trarsmit*s» Server System 1! 

thru 1 “"receive™» virtual terminal messages J 

Zz Z 1 I 
i 1 

A a 1 User Syste2n “receive™» Server System ! 
thru i “transmit"» virtual termirat messages ! 

Z Z I ! 

Device addresses are advisory only-e- The receiving systea can 


direct a message to any appropriate peripherai device» based on 
its cwn requirenerntse 


Notes Line printer data is atlowed in both directions. When a 
System receives Line printer cata» it can print it on any 
available printer» independertly of whether the eee is 
termed a User system or a Server System. 
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MESSAGE FORMATS 


BASIC DATA COMMUNICATION MESSAGES 


As per the line protocols» the belcw sessage format adheres to the 
criteria of standard RJE message forratting: 


SATSDD EB 
ORMTAA<<9=------ TEXT ---7--- -->IC 
HM#X12 XC 


The individual characters in this message function as fotlows: 


Ae SQH - This is the standérd ASCII character which is 
used to indicate data transmission as opposed to 
connection establishment communication. 


‘ee ARM - The "Acknowledge Received Message” character 
which is used to accept or reject the last message 
block received. 


Co TM# - The “Transmission Number™ character used in the 

po, ackrowledgement of a messages It represents one of two 

( values Calternating characters) selected for 
2 implementation by SYCOM. The characters "5" and *&* 


are used by the User System SYCOM whereas” the 
characters “F™ and “U" are used by the Server  Systen 
SYCCM. 


Ce STX = A standard control character used to delimit the 
preceding header characters from the message. 


E. DA1/CA2 = Two characters representing a "Device 
Address” value. 


Fe TEXT - The message text field usually containing data 
(record images or a message). 


Ce ETX - The standard “endwof-text™ control character. 


H » BCC = A Block Check Character which is coaprised of a 
Longitudinal parity bit corfiguraticn that is used» by 
the hardware» to verify that the message has_ been 
received correctly. 


SYSTEM CONTROL MESSAGE 


System contrel messages a3re used te excharge control type data 
between systems» A complete descrictive tist follows the message 
format which is a variation of the besic message format: 
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SATSDDCC. OO EB 
ORMTAADD<---- variables Ctext) c7~=->TC 
HM#X1212 — | | xc 

Here we have the addition of the "CL1"/"CD2" characters. These 

two characters represent the system nessage “type” code? which 


may or may not be followed by variable control data. 


ODT MESSAGES 


The CDT Message format uses the basic format without alteration. 
There are no frovistons for blocking CDT Messages» therefore» the 
rule is? one ODT Message per certrcl message block. The format 
of this type message is as foilows: 


SATSDD EB 

ORMTAACoreseree= TEXT sett ctrcn- >TC 

HM#X12_ | | | XC 
"01" 


CARD READER/PUNCH MESSAGE 


The format for card reader/punch data images is as follows: The 
"RS" (CRecord Separator) character used between each card image 
provides the means for blocking. 


SATSDD R , EB 


ORMTAA<“--- card image -~~->S<-""" card image ---->TC 
HM#X12 | | | xe 
"92" 


LINE FRINTER MESSAGE 


The fcllowing format variation is used to transmit Line Printer 
data lines between systems: 


SATSDDP | R EB 


ORMTAAC<~--= Line image -~-">§<---- Line image -=-->TC 
HM#X12C | | XC 


"O3x" 
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This format is the same as the Card Reader/Punch format except 


that the “PCC™ character is utilized. The value of this field 
can be one of the following codes: 


PCC Function 

0 Print» no spacing 

1 Prirts» single space 

2 Prints double space 

A Skip to channel 1 (tcn of page) 
B i 2 

C " 3 

D i 4 

E ” 5 

F = 6 

G 7 

H " 8 

I = 9 

J . 19 

K " 11 

L ” 12 (bottom of page) 
H o 8 


FILE TRANSFER FESSAGE 

The File Transfer message format is zglso the same as that used to 
transfer card images. Although the “PCC™" character field is 
included» it is only there to maintair message conformity: 


’ 


SATSDD F EB 
ORMTAA<---- record data --°->S<----record data ---->IC 
HM#X12 XC 


VIRTUAL TERMINAL MESSAGE 


The Wessage format utilized for virtual terminal messages is the 
basic message format» with one excertion: the “device address*™ 
for é virtuet terminal is comprisec of two letters C1 lowers i1 
upper “transmit™s i upper» 1 tower “receive™) and will vary by 
terminal. The format 1s as follows: (Termiral and ODT messages 
are “"rot™ blocked.) 


re | E=5_ 
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SATSDD | 7 | E83 


ORMTAACSt*S4""""-== message text “"-<<"<<=>1C 


HM#xX12 xe 


"xX" Ctransmit) 
"Xx" Creceitved 


FILE SEPARATOR MESSAGES 


This message format is utilized by SYCOM when it is necessary to 
transfer a “symbolic file header"» indicate the “beginning of a 
file"» or indicate the “erd of a file". This applies equally to 
the “Card Reader/Punch"™>» "Line Printer"™» and “File Transfer 
operations. Tc accomplish this» there are three minor variations 
to the Fiie Transfer Message format snhich are identified with the 
following message formats. 


The “Card Reacer/Punch"™» “Line Printer"»s and “File Transfer” 


Begin File Message 


The fermat for the Begin File message is as follows: 


SATSDOF EB 
ORMTAASI<““-~- file name =-=->1C 
HM#X1i2 | xC 
"O2" 
"Oo 3" 


End File Message 


The format for the “erd file™ message is as follows: 


SATSDDF EB 
ORMTAAS2<""~ FileName -~-->TC 
HM#X1i2 Xe 
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PROGRAM=to=PRCGRAM MESSAGES 


The fcllowing message format pertairs to SYCOM's “program-to- 
Program” facilitys thru a “Remote File": 


REMOTE.KEY €1G characters) 2% Message “header”. 


- RSN C 4) % Relative Station Number for 
2 “virtual terminal™ as defined 
% for the program-to7progran 
% resote filer usuatly "0001". 
m" LENGTH C 4&4) Z Length of message text. 
- TYPE C 2) | Z Message types usually 00". 
MESSAGE TEXT Cnn characters) Z Maximum is “buffersize*™. 
m= LENGTH C 4) Z Length of message text. 


PROGRAM=to~SYCOM MESSAGES 


SYCOM has the tnherent capability to accept command strings from 
an apelication program and respond with reply messages thru the 
"Program=tomSYCOM”™ interface facility. This facility utilizes 
the “cueue™ mechanisms» whereby SYCO*¥ reads input from the queue 
file "SYCOM/OUTOQ™ and writes replies into the queue (file 
"SYCCM/INQ"*. {If these queue file names seem reverseds its 
because they are oriented te the application programe) 
Input/Output message formats are defired as fcltows: 


Input CSYCOM/INQ): 


Prograa supolted I/D 4 bytes 
Fitter 6 bytes 
SYCOM command string 1940 bytes (maximum) 


1$50 bytes (maximum) 


Cutput CSYCOM/OUTQ): 


Program supplied I/D 4 bytes 
Reply message Length 4 bytes 
Reply message cade 2 bytes 
SYCOM reply message 1940 bytes Cmaxinum) 


| 1950 bytes Cmaximum) 
Reply message Length & bytes | 
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APPENDIX F2 RESTRICTED MCP COMMAND SUMMARY 


ALL input commands that are prefixed with a "?" are sent directly 
to the MCP exactly as entered. The MCP then generates 
appropriate responses which are sent to the terminal via the 
Network Controtler. Security restrictions have imposed certain 
constraints on MCP commands from remcte terminaise Also» certain 
commands» such as those which alter system ortions» purges». or 
clear system peripherals» have keer disallecwed for a remote 
terminal. The following List represents the MCP command subset 
permitted from User System terminais and the User ODOT. | 


The fcllowing Command Subset is Listec in the order as described 
in the 81800/81700 Systems Syster Software Operational Guide 
Cassociated dccumentation). Any ccamand listed below which is 
suffixed with "US" requires the ccamand to be entered with a 
valid “usercode"/"password™ combiraticne 


Library Maintenance Instructions 


6 
“ 
pa 


Change CUS) 
AD Add CUS) 

L0 Load CUS) 
Cump CUS) 
UN Unload CUS) 
RE kemove CUS) 


*6@© 8 @ 6 
CS 
Cc 


Program Control Instructions 


6 
C9 
oun 


Compile CUS) 

DY Cynamic 

EX Execute (U5) 
Modify Header CUS) 
MO Modify CUS) 

CO Compile CUS) 


» @ ¢@ @ @ 
=z 
a 


Program Control Instruction Attributes 


~- AF After 

» AN After.Number 
CA Conditional 
CG Charge (Ccertain restrictions apply) 
DS DynamiceSpaces 


» FI Fite 

e FR Freeze 

e HO Hold 

» IN MInterp interpreter 


IT Intrinsic.Nage 
ID Intrinsic.Cirectory 
>» ME Memory 
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- OV <Qverride 
- PR Priority 
» SC Schedule-Priority 
» SW Switch 
2 TH Then 
« UC Unconditional 
« UF Unfreeze 
« UV Unoverride 


System Control 


System Control 


& 


* @¢ 6668866 6 


Virtuat.Disk 


Instructions 


Response to ACCEPT 

Display BACKUP files CUS) 
Compute : 

Core usage 

Date cf file CUS) 

Dump memory and cortirue 
Dump memory and discortinue 
Discontinue prograr 

Display internal file rame 
Finat reel of untabeled tape file 
Force from schedule 

Resume stopped proagrasg 

Hold in waiting schedule 
Hold in waiting schedule until job EOJ 
Close output file with curge 
Display MIX 

Optional file resconse 
Continue processing 

Display peripheral status 
Display directory 

Print memory duno 

Change priority 

Continue processing 


Instructions Ccontinued) 


Prod schedule 

Query file CUS) 

Query program 

Remove backup files CUS) 
Remove duplicate disk file 
Remove jobs from schecule 
Change schedule ortcrity 
suspend processing 

Set switch 

Tire and date 

Time interrogation 

Test switches 

Assign unlabeted file 
Display MCP date 

Display current MCP and interpreter 


Fn E DANEEL a anh EE a a nen te 7 Denieaerreewa eee mers ep nt Gun bE RANCRANESE ft tee Nites teat RnR Secchi, oat ol te St ot Seta oon os 
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- WS Display schedule 
WT D~Disptay MCP time 4 2. 
WY Program status interrcgétion | 


Job Spawning Control Attributes 


- QU Queue command 
« US Usercode command 
« 2Q Zip cueue command 


MIX related MCP commards may refer crly to jobs initiated by the 
same remote terminal where the initiat command was input. ALt 
MCP commands fust be entered in UPPER CASE. 
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PARAMETERS FILE ATTRIBUTES 


The PARAMETERS fite is a disk files» data type» with one physical 


record of 180 characters. 


shown belowe 


RECORC FORMAT 


Length 
bits) 


Default 
Value 


This paraesgeters record is formatted as 


Description 


Versian 
Fittler 


CURREAT.DATE 


STATICN.ID 
MAXeBLFFER.SIZE 
MAXeMESSAGES 


TIMECUTSINTERVAL 
DEBUGECING 
DISK»TRACING 
NOFS 


NOFTP.P 


QUE.P 


136 


Current verston of file. 
Reserved for identifier. 


Run date as “dd mm yy"s C9 
bytes). 


~ 


System identifiers 17 bytes. 
File Trarsfer buffer size. 


NDL queue sizee 


A value for message display 
Intervalse 


CTEBUG on/off switche Default 
cf "0" inhibits debugging. 


Controls disk tracings OQ=no 
=yese 


when “sets this parameter 
inhibits File Separators. 


Khen "set", this parameter 
rermits File Transfers to 
cccurs else they are denied. 


When “set"» this parameter 
permits “program~to~SYC0QM* 
communications. 

cccurs else they are denied. 


Sei et eclieaa rh an ce eet Atlee name Sade egaan gue wean esteem 


join pa a i hi ae ee tap er ean A Pe = 
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Length Default 
Cin bits) | nee Cescription 
WAITwP 1 | — Q Tc shutdown or not shutdown 


when receiving a “disconnect 
@message™ from another SYCOM. 
Q = shutdowns 1 = idle. 


Fitter 2 00 Reserved for future use. 
Default N input a 

buffers 

TRACE RB 16 & Disk tracer records per blk. 
Default WN output 8B | 

buffers 
TRACE «BeA 16 10 Disk trace» blocks per area. 
Default Pseudosignal @ can PSEUDOsignal character 

Character 
TRACE «AREAS 8 19 Disk trace» number of areas. 
Filter 8 900 Feserved for future use 
GROUPSIZE 24 9 Size of groups within a family 

cf the transfers 
TERMINALS .RFE# 24 , 000 Remote File Nuasber for the 
file TERMINALS> 3 bytes. 
SYCO™ prog name 249 SYCOM*s names 30 bytese 
SYCOM job number 32 SYCOM*®S “job #"5 4&4 bytese 
Filler 256 Reserved for identifier. 
COMPILE.DATE “2 = Compile date as “dd mam yy">s 
| C9 bytes). 

Fitter 256 = o9 Reserved for identifier. 

COMPILE«TIME 80 non Compile time as "hhtmmtss.et" 
| | €10 bytes). | 

Fitler | 88 Reserved for future usesees 
Local Release I/D 72 Release version identifier 


of the tocal SYCOM program. 


Remote Release I/D 72 Release version identifier 
cf the remcte SYCOM program. 


Filler 16 | Availabte. 
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APPENDIX H2 SUMMARY OF FILES 


cick Nb a ile ahaa aidan brn 


File Records/ 
Number Internal Name External Name Device Block 
0 DEEUG <sycom>/DEBUG printer + 132/1 
1 DISK TRACE <sycom>/TRACE disk | | 132/74 
2 | FILE_NAMES FILE_NAMES disk 72/1 
3 FILENAME Q FILENAMES queue 180/1 
4 IN IN * disk/tape £180/1# 
5 IN_OUT <sycom>/In_OUT PBD 132/1 
6 IN_ Q <sycom>/InQ queue 2000/1 
f LINK LINK # remote 2000/1 
a LINK_Q <sycom>/LINK.Q queue 2000/1 
(> 9 LIST <sycom>/LISTeTRACE printer 132/1 
; 10 NEWPARAMS <sycow#>/NEWPARAMS card/disk 80/1 
11 OLCTRACE <sycom>/CLOTRACE disk 1327/4 
12 CUT QUT ** disk/tape *180/1« 
13 OUT_4@ <sycom>/CLTQ queue 200C/1 
14 PARAMETERS <sycom>/PARAMETERS disk 180/1 
15 PUT_QFILE <sycom>/PLI.-QUEUVUE disk 5358/1 
16 RJE_ 9 <sycom>/RJE 20 queue 4557/1 
17 RJECARCS RJE/CARDS # card 80/1 
18 RJEPRINT RJE/PRINT printer + 132/1 
19 RJEPUNCH RJE/PUNCH punch + 80/1 
20 STATISTICS <sycomo/STATISTICS disk 180/1 
21 TERMINALS TERMINALS remote 2000/1 
$eseotesoeeesesce se Ssteesea SSeS tes sees Seas es eseeassosSsesSsese-s=e4 
*# - These files are changed to the actual device type» 


| | | | | | | H-2 
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record size» and file name sfecified in the fite 
transfer command. 


+ = Backup allowed. 
# - Or user specified name. 


=a = Use tnput blocking. 


* Notes Printer or printer backup cisk file. 
x* Note: The actual file name as sfrecified in the COPY command. 
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APPENDIX Is SAMPLE APPLICATION PROGRAMS 


This program was designed basically te test “program~-to~progran” 
com@unication functions of SYCOM. What this sample application 
progréem provides 1s the mechanics cf what is recessary for this 
communication processe The user carn expand upon this sample to 
cregte a program with the desired capabilities as required. The 
program is written in UPL which is available for this purpose. 


The orly data communication type functions required for this type 
of apclicétion program is to “read™ input messages from a Remote 
File and “write”™ reply messages into the same Remote File. This 
message interfacing architecture has teen established for this 
purpose and must bes therefore» adhered to at all times. 


PROGRAM=to-PRCGRAM CUser System) 


COMPILE USER/TEST UPL LIZ 


& DETAIL 
& SIZE 
& PASS_END 
FILE RFUSER CDEVICE = REMOTE> NUMBER_OF_STATIONS = 1» 
REMOTE_KEYs» RECORDS = 80/1» BUFFERS = 2)3 
DEFINE CH | AS ACKARACTERGS 
DECLARE TEXT CHK (€80)> 
REPLY CH Cec); 
DECLARE 1 RMT_KEY CH C1C)>» 
2 RMT_RSN CH € 3)> 
2 RMT_LENGTH CH C 4)>» 
2 KMT_TYPE CH C 3)» 
1 REAC_KEY CH (10)> 
2 READ_RSN CH C€ 3)» 
2 READ_LENGTH CH C 4)» 
2 READ_TYPE CH € 3)3 


RMI_RSN t= "QO1"3 
RMT_LENGTH := "0080"3 
RMT_TYPE s= "000"5 


First station in “family*™. 
Stancaerd messace lengthe 
MCS type code. 


NNR 


CPEN RFUSEFR INPUT» OUTPUT> 


Lisi bea si 
I 1 


a i Yanbu een eon eel aback nat L aS 
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DC TEST_LOCP FOREVER3 


ACCEPT TEXT> 


WRITE RFUSER CRMT_KEY] CTEXT)>5 


2 Outputs messages 
2 directty to the 
% Network Controller. 
Z for detivery to the 
% Other systeme 
READ RFUSER [CREAD_KEY] CREPLY)> Z% Obtains input directly 
| 2 for the Network 
% Controtler. 
ON EOF STOP=s 2% In case of "QC" 
DISPLAY REPLY> 
ENC TEST_LOCP> 
FINI; 
_— = SE 28 om eo on on oe we oe os ee ee ee we ee es “fJsfiffJranws9 — = en ee 4m oe ae on om «8 a a oe ee oe we we oe 2 os On on am a om a 
PROCRAM=to~mPRCGRAM CServer System) 
COMPILE SERVER/TEST UPL LI} 
& DETAIL 
& SIZE 
& PASS_END 
FILE RFSERVER CDEVICE = REMOTE» NUMBER_OF_STATIONS = 1» 
REMCTE_KEYs» RECORDS = 80/1» BUFFERS = 2)% 
DEFINE CH AS &CHARACTERAs 
DECLAFE TEXT CH C80)» 
1 RMTI_KEY CH €1C)» 
2 RMT_RSN CH € 3)» 
2 RMT_LENGTH CH € 4&4)» 
2 RMT_TYPE CH € 33>» 
1 READ_KEY CH €1C)» 
2 KFEAD_RSN CH € 3)» 
2 READ_LENGTH | CH C 4)» 
2 READ_TYPE CH C 3)s 
RMTI_LRSN s= "001s 4 First station in “family” 


RMT_LENGTH s= *0080*; %Z Standard message Length 
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RMT_TYPE 3s= 


"000"» 


OPEN RFSERVER INPUT» OUTPUT; 


DC TEST_LOCP FOREVERs> 
~ REACT RFSERVER 


ON EOF STOP> 
WRITE RFSERVER (CRMT_KEY] 
ENC TEST_LECPs 
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@ MCS tyce code 


CREAD_LKEY] CTEXT)> 2 Input from User AP 


%Z In case of "QC... 
CTEXT)> 2Z Output to User AP 
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GLOSSARY OF TERMS AND ACRONYMS 


Systeas Communications Modute CSYCC¥) 20 Dec 1979 B1800 Series a 
Software Cperationat Guide Page = 210 Section VIII Glossary of 
Terms and Acroryms CRevision "C™). , | 


This glossary defines SYCOM terms and acronyms used throughout 
this software cperational quidee Fer ease of use» the glossary 
1S seéepareted into two sections> Terms and Acronyms. Each 
section is sequenced alphabetically for quick reference. | 


TERMS 
TERM 2 DEFINITION 


ACTIVE STATION: 


A work station Cterminat) that is currentty eligible for 
entering or accepting messages. 


AMERICAN STANDARD CODE FOR INFORMATION INTERCHANGE CASCII):= 

This codes established by the American Standards 
Associations» defines codes for a set of characters to he 
used in the interchange between business equipment over 
telephone and telegraph circuits. The code consists of 128 


Graphic and control characters. 


APPLICATION PROGRAMS 

A program that processes data and is unique to one type of 
epolicaticon. It ais sometimes referred to as a “user 
program”. 


AUTQ CALL UNIT= 

A device furnished by the communications common carrier 
which altows a User System toa automatically establish a 
dialed tink tc a Server System over a communications 
network. 
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TERM = DEFINITICA 


BEGINNING OF JOB CBOJ) 
The execution of a sin 
the system. 


gie progres unit to be performed by 


BINARY CARD: 
A punched card with aultiple punches in any one or more 
columns which represent a nonwASCII character. 


BIT 


The smaitest unit of informaticr in a binary systen. 


EIIS PER SECOND Cbps): 

The expression bits~perssecond is used tc express the speed 
at which bits of data are transmitted over a communications 
channel cr interrally woved wittin a computer system. 


BLOCK: 
A group of characters/bits trarsmitted as a single unit of 
datae Also» see Block Check Character. 


BLOCK CHECK CHARACTER C(BCC)> 
The Block Check Character is a character appended to data 
Elocks transmittec for the purpcse of error detection and 


parity control. 


ELOCKING FACTOR: 


The maximum number of charécters atitowed per single 
transmission. 


BROADCAST: : 
The simultaneous dissemination cf information to a number of 
work stations Cterninals). 


BUFFER 
This is a temporary storage area that 1s used during the 
transfer of data from one device to another. Tt is atso 


used tec compenséte for variaticrs in bit rates or timing of 
events within the system. 


CARRIAGE CONTROL: 


Controls the verticat paper motion for a tine printer. 


CHANNEL: 
A device that directs the flow cf data between a computer's 
Main memory and input/output devices. 
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IERM = DEFINITION 


CHARACTER? = oo 5 mF 
A digit» Letter» or special characters. (Letters can be both 
upper or lower case.) | | 


COMMON CARRIER: 


A company» such as Sett Telephone» that provides 
communication Lines as a public service. 

COMMON CARRIER EXCHANGES 

A defined geographical areas served by a communications 


Carriers» within which the carrier provides this service. 


COMMUNICATION LINE: 
Any meditus» such as awire cr «e telephone circuits that 
connects a terminal with the cogputer.e 


CONDITIONED LINES: 

These are private and teased transmission Lines that are 
conditioned to reduce data cistortion while providing 
transmission cf data at Lower errcr rates. 


CONNECTIONS 
An established data transmission path between two or more 
computer systems. It is consicered either a temporary or 


permanent connections depending on whether it 1s established 
with or without switching facilities» respectively. 


CONTROL CARD: 

A punched card which contains information which identifies a 
job or describes its requiresgzents te the MCP. The first 
column must contain an invalid chéracter €80 column cards?) 
cr a question mark “2?” €96 colugnn cards). 


CONTROL STATE? 


The term “control state» fcr this systems refers to a 
program that can assume control cf the system"’s processor 
with privileged operands. As a rule» the type of 


control-state program suggested here infers an “operating 
system" or MCP. 


CONVERSATIONAL MODE= 7 


An operational mode in which sessage data (full or partial 


Ressages) tis used in Lieu of» cr in additian to» control 
characters as replies for messace information. 
QATA 


Cata is any represertation cf informations such as graphic 
characters» to which meaning micht be assigned. 


‘apy Fly i 
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TERM = DEFINITION 


CATA COMMUNICATIONS: 

Lata communication is a method cf transferring encoded data 
by means of electrical trarsmissions between two or more 
tergainals and/or systems. 


DATA COMMUNICATIONS SYSTEM: 

A data communications system which consists of two or more 
computer systems that are Linkec be means of a communication 
Line(s) for the purpose of data exchangee 


CATA LINK 

A composite of computer systems and the interconnect ing 
network» together with control procedures» operating in a 
rarticuler mode that permits irformattor to be exchanged 
tetween these systems. 


CATA SET: 

A device that provides an interface bdvdetween a data 
communications system and a data coamunications line. Most 
cata communication tLines use a modulated carrier for data 
transfer. The dataset provides the Logic to modify the 
cata that is being received cr transmitted between terainals 
and the systeme 


DATA SET READY: 
A signal provided by the Data Set. 


LATA TRANSMISSION: 
Cata transmission consists of transmitting data between two 
or more computer systems in a system network. 


CISCONNECT COEQT): 

The tern Cand mnemonic) for the "DLE EOT* communication 
control sequence which 1s used to signal that a “disconnect™ 
cf a switched circuit must be iritiated. 


QIAL-QuT: | 
The use of an Auto Catt Unit to establish a “switched” 
connecticn between two (2) computers. 


CIAL“UP> : 
The use of a dial or touchtone data set to establish a 
“switchec™ connection tetween two €2) computers. 


EISK CARTRIDGE: 

A secondary data storage device much the same as a “disk 
rack™ but usually smattler tn size. It can be moved = ontine 
cr cfftire. 
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IERM : DEFINITION 


CISK DIRECTORY: 7 
A disk~resident table that contains the name and type of 
files together with a pointer to the disk file header or 


subdirectory for all permanent files which reside on disk- 


CISK PACK: 
A secondary data storage device that can be moved online or 
cffline. 


DISKTPACK*IDENTIFIER Cdp-id): 
An identifier which is the name assigned to a disk pack or 
cisk cartridges 


EXTENDED BINARY CODED QECIMAL INTERCHANGE CODE CEBCDIC)= 
A code consisting of 8 "bits shich is used to represent 256 
unique letters» numbers and special characters. 


ERROR: | | 

Any received character or secuerce of characters that does 
not conform to those transmittecr are considered to be in 
error. 


ERROR RECOVERY PROCEDURES: 

These are data communication control precedures used to 
restcre normal operaticns te a data link after an error 
condition has occurred. 


FAMILY NAME: | 
A adentifier used as a file rawe» or the name assigned to 
identify a main file with sub-directory entries. 


FILE SECURITY: 


The procedures cr spectal devices used to prevent access to 
cr use of data or programs withcut authorization. 


FILE IDENTIFIER: 

Alt disk filetidentifiers used cn the system must be unique 
tc prevent cupticate filenames. A file identifier can be 
comprised of any combination of the following file> 
identifier options: | 


« fileridentifier 
e familyrrame/fileridentifier 
- adpwrid/fasily-name/filetidentifier 


HALE-DUPLEX CHANNEL: 

This is a communication chanrel in which the signaling may 
te In either directions but not ar both directions 
simultanecusly. . 


COMPANY CONFIDENTIAL 
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TERM = DEFINITION 


HALE-DUPLEX TRANSMISSION: 

This is a type of data transmisston where tnformation 15 
sent in crntly one direction at a timee It cannot send data 
in both directions simultaneously. 


HARD COPY: 


Cenerally» the printed copy of some material in a readable 
form is considered to be “*hard copy. This would inctude 
computer printed media such as Reports» Listings and 
documents tike this Software Operationai Guide. 

; IDENTIFIER: 
A word consisting of from cre to seventeen numerics 
elphabetic» or special characters in combination. 
INTEGER: 
A whole number as opposed to a fractions that 31S» a number 


that contains the unit of €1) an exact number of timese 


AINTERWSYSIEM COMMUNICATIONS: . 
The ability for a terminal or ecrogra®t in one system to 
communicéte with a program in arcther system. 


ANTRATSYSTIEM COMMUNICATIONS: ; 
The restricted ability for a tergwinal or program in a system 
to communicate with another procram in the same system. 


498 
A “job" to this system is any frogram that is executable 
under the control of the MCPs SYCOM is a job. 


JO8 NUMBERS: 
A unique number assigned by the system's MCP to each job. 
that is executec under its control. 


398 SPAWNING: 

The ability for a user to execute jobs under program control 
and maintain an adequate level of control over those jobs 
curtng their executione 


A device for the encoding of data by key depressions which 
causes the generation of the selected code element. 


LEASED LINE: 
A data transmission Line reserved for the exclusive use of a 
customer (data center). 
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TERM : DEFINITION 


rier SYSTEMS a 7 

"Like system™ is a system with the physical 
sisasaceaeta cial similar to those of a target system. For a 
B1800/81700 systemp a “Like” system would be either a B1800 
er B1700 system. 


LINE: — 
A data communications Line linking two €2) computers or a 
computer and its associated teraginalse 


LINE ADAPTER: 

A line adapter consists hardware and/or software togic used 
to interface 3 dataset or communications line into a 
fulticline or singlerline I/0 certrol unit. 


LINE SWITCHING: | 

The technique of temporarily connecting two communications 
Lines tcgether so that twe ccaputers ard/or a computer and 
its associated terminals can exchange data. 


LOS~OQEFFs 

The procedure by which auser erds a data exchange session 
either between two computers or between a computer and a 
terminal. 


LOGON: | 
The procedure by which a user establishes a data exchange 
session between two computers cr a4 comnuter and a terminal. 


LOGICAL STATION NUMBER CLSN): - 
The identificaticn number assigred by the Network Controtler 
to a given station (terminal). The Logical Station Number 
has no relationship to file names» but is determined by the 
crder in which the stations are defined in the Network 
Controtler. 


MASTER CONTROL PROGRAM CMCP): 
The Master Control Program is the master “control state” 
program Coperating system) usec tn alt 81300/81700 series 
computers for system control. 


MESSASGE= 
A sequence of characters arranged in a form suitable for the 
Purpose of conveying inforsgaticr. A message contains’ the 


data to be conveyed (the text) ard may» in additions contain 
communications characters to aic in the routing or handling 
cf the messagee MESSAGES A secuence cof characters arranged 
in a forw suitable | | 
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TERM = DEFINITION 


MESSAGE FORMAL 

A message format defines the plécement of message elements 
within the message texte These elements woutd be such items 
és message headers control chéracters» end text data. 


MESSAGE HEADERS 

Every message moved between a terminal and the SMCS» or an 
epplication program for that matters» is prefixed with a 
"message header”. This header contains the Station 
ettributes necessary to identify the station when the time 
comes to return areply message. 


MESSAGE NUMBERING: 

Message numbering is the secuencing' cf the messages 
transmitted by the communicaéticns syste#® to ensure that ait 
messages sent are in turn receivede . 


MODEM: 


Same as “Cata Set*. 


MULTITEILE IDENTIFIER CMF=ID)> 
A generalization for a group of files with the same “family 
name™ but with different file names. 


MULTISLINE CONTROL CMLCQ= 
The C€MLC) is an I/0 jcontrol device that provides the 
functional control between computer hardware and the tine 


edapterse The control is an integrat part of a multirLline 
communications subsystem. : 
NETWORK: 


A number of data communication lines ccannecting the User 
System with remote work stations (terminals). 


RETWORK CONTROLLER: 

The NDL generated data co#sturication program used by SYCOM 
to interface with the work statiors (Cterminats)} and other 
SyStemSe : | , 


NETWORK CEFINITION LANGUAGE CNDLJ= 

A descriptive» free-form language» for defining and 
implementing a data commuricetions networke The NDL 
compiler analyzes the input statements and generates a 
custom Network Controller. 


NORMAL STATE: 

The term “normal state” for this systems» generally refers to 
@ program which has no facitittes to seize control of a 
System"*s processcrs> as opposed to “control state”. Ce@ege» 
SYCOM is &@ normal state prograg.) 
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IERM 2 DEFINITION 


got: 7 es ee a 

The currently accepted term for the 81809/817090 systems? 
"“Qperator Display Terminat™ (Cusuatly a video display 
terminal). Usage in this docusent will be the abbreviation 
"User ODT". 


GQEELINE=: | 
There are two facets to this ters for the SYCOM systems, 1) 
@ system is “offline” when no communications Link currently 


exists between it and a host systems» and 2) a systen? 
terminal» CDT» or program is “offline” when it 1s not | 
logicaily connected ! to an apglication program in a host 
system. 

ONLINE: 

There are two meanings for this term in a SYCOM system», 1) 


a system is “*ontine* when a conmunicaticns link currently 
exists between it and a host system that provides processing 
services» ard 2) aterminatls» CCT» or program in a User 
System its 1 “ontline™ when it ts Logically connected to an 
epplication program in a host system. (The system must be 
cntine in order for a tersirat» ODT» or program to be 3 
online.) i , 


PARTICIPATE: 


Message Control System CSMCS) which allows it to 
“participate” in all innut/cutput message traffic between 
the Network Controtter and an application program. In 
reference to a SYCOM system» the SMCS is not permitted to 
participate in SYCOM's message traffic. 


PASSWORD: - | 
A unique string of characters that a programe computer 
computer operators cr termiral user must supply to meet 


security requirements before gaining access to data/files. 
The password is confidential as opposed to the *usercode”" 
which 1s note | 


POINITTQSPOINT CONNECTION: | _ 

This is 2 configuration tin whick a network connection is 
established between two» arc only twes computers. The 
connection may tnclude a switching facility. | 


PRIVATE LINE? 
This would De a data communications line which has  ~»been 
furnished to the user for exclusive usee 
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TERM = DEFINITION 


PSEUDO CARD READER: 

In a 81800/B170C system» a pseuco card reader ts in fact a 
disk file. The disk file may be created via cards» program 
cutpute or through a terminal. When a program requires an 
input carc file» the pseudo card reader can be substituted» 
as that file can be appropriately ltabeled. 


QUEUES 
A tlogicat collection of messages awaiting transmission or 
processinge 


REMOTE JOB8> 1 

Submisston of control statements and data from aeéeremote 
station Cterminal/computer)» causing the job described to be 
scheduled and executed at- another system. 


REMOTE JOB ENTRY CRJED= 

The Remote Job Entry program is a method by which a remote 
computer executes oor complies programs sent to 1t by other 
computerss which are considerec termirat devices. 


FEMOTE SUPERVISORY CONTROL STATION CRSE): 

This 1s an tnput/output device tlecated on a User System 
Cremote to a Server System) which provides the operator wita 
the ability to control jobs and to request information § from 
the Server System. 


RJEZ TERMINAL: 
The official name for the software system from which SYCOM 
derived its basic capabilities. 


RJE STATION: 

For this systems the terms “RJE Station" and “User System™ 
are equivalent. The new ter® is used to denote a system 
with many additional capabilities and potentials» therefore» 
the term “RJE Station” 3s no tereer apprecpriate. 


RELATIVE STATION NUMBER CRSN)= 
Is the position within the Remcte File familys assigned at 
generation time. 


SEMANTICS: 


The relationship between symbots and their meaningse 


SERVER SYSTEM: | 
A Server System 1s a passive system which provides computing 
services to the “User Syster"s Locally cr remotely. 
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TERM =: DEFINITION 


SESSIONS _ 7 oe 

A period of time during which a user engages in dialog 
bketween a terminal ard a computer or between two computers. 
(The elapsed time between when the user Logs~ on the system 
end when the lLoagqvwoff occurs. | 


SESSION NUMBER? 
A unique number assigned by a criginating system to each 
sessi0ne : 


SINGLE LINE CONTROL CSLC) | 
This is an I/0 contrct device that provides the functional 
controi tCetween a computers mair frame and a line adapter. 


This control is an integral part of a single Line 
communicetions subssystem. 
SiTE IO: 


A unique i/7-character identifier sent in a special message 
format to a server system prior to being togged-on to 
provide a positive means of idertificatian» independent of 
eny other system security. | 


ig! Loc: i 
A disk file that contains att input/output messages sent to Cae 
end received from the User OCT. 


SPOOLINSG: | - | 
The reading and writing of $input/outout data streams on 
secondary storage devices» In z¢ format conventent for later 
cutput operations and/cr processinge. 


SIATION: 
Same as “TERMINAL"™. 


SWITCHED LINE> | 

A communications Line with which a temporary connection 
tetween a User System ard a Server System is established by 
dialing.» | 


SWITCHING: _ | 

This is an operation involving the interconnecting of 
circuits =in order to establish a Temporary communications 
link between two or more systemse 
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TERM 3 DEFINITION 


SYNCHRONOUS TRANSMISSION: 

A data transmission process In which the sending’ and 
receiving devices are cperating continuously at 
substantially the sane frequency and are maintained» by 
means of corrections ir a destred phase relationship. 


ae ce DISK: 


disk pack or disk cartridge that is inittatized as a 


system pack. A syster pack is under control of the MCP and 
cne or more must be opresert ona systen for the MCP to 
function. Head "per“track disk is always considered system 
cisk-. 

JERMINAL: 


This %s an input/output device designed to receive and send 
source data in an environment asscciated with the job to be 


rerformed. Furthers it is capable of sending entries to» 
aend obtainina output from» the system of which it 18 a parte 
TEXT: 


A sequence of characters forming the information to be 
conveyed between systems and/or terminals and systems. 


(> IRANSMISSION: 


Same as Data Transmission. 


TRANSMISSION BLOCK: 

A transmission block may contain atl or part of a message 
block and 1s independent of the nessageCs) from from which 
its characters are taken. 


JRANSPARENT MODE: 
An operational mode in which alt ccded combinations of 
eight~bit characters are allowed as message text characterse 


UNIT DIVICE IDENTIFIER Cugid: 
The mnemonic identifier assigned to each peripheral device 
eéttaeched to the systeme 


USER QOT: 
The User System's Operator Display Termirat CODT). ! 


USER SYSTEM: 

A User System 1s the active participant system providing 
local service to the user wishing to utilize another 
computing resourcer Locally or remotely. 
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USERCQODE | 
A symbol which consists of from one to sachet characters to 
identify the system usere 


NIRTUAL JERMINAL: 

A togicat communications capability which permits a 
terminals» OOT» or program in cre system to “interact” with 
an application program in another system. 


NOT: | 
Video Display forecnas A video type work work station 
Cterminalt) such as the T0820 anc 10830 terminal devices. 


WAITING SCHEDULE: 
Contains the names and runstiwe attributes of jobs that are 
Waiting to be placed into the Active Schedule. 


£iP 


A method by which a progran es as SYCOM» communicates with 


the MCP for certain specific MCP functions. 


ACRONYMS 

ACU Auto Call Unit. 

AP Application Progra 
ASCII American Standard Code for Information 

Interchange 

BCC Block Check Character 

BOJ Beginning Of Job 

bp Bits Per Second 

D/S Data Set 

DND Direct Distance Dieting 
dp~id Disk Pack IDentifier 

EOJ End Of Jab 

1/0 Input/Outout 

isn Logical Station Nugber 
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MCP 


NC 


Master Control Procram 
Network Controller 

Network Definitior Language 
Network Informaticr File 
Operator's Display Terminal 
Remote Job Entry 

Relative Statior Number 
supervisory Message Control Systea 
Software Operational Guide 
Systems Communications Module 
Unit Device Idertitier 


Video Display Termiral 
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